[DOCS] CLI reference omits `--background` alias for background sessions
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/cli-reference
https://code.claude.com/docs/en/agent-view
https://code.claude.com/docs/en/commands
Section/Topic
claude --bg / background session launch flag documentation.
Current Documentation
The CLI reference lists:
--bg Start the session as a background agent and return immediately.
The agent-view docs say:
Pass --bg to start a session that goes straight to the background:
The commands reference documents slash command aliases:
/background [prompt]... Alias:/bg
What's Wrong or Missing?
Claude Code v2.1.187 fixed claude --help not listing the --bg/--background flag. The docs mention --bg, but do not document the CLI alias --background.
Suggested Improvement
Update the CLI flag table and relevant Agent View examples/text to show both aliases, for example:
--bg,--background
Optionally add one example using claude --background "<prompt>".
Impact
Low - Minor confusion or inconvenience
Additional Context
v2.1.187 changelog context: Fixed claude --help not listing the --bg/--background flag.
Duplicate search found no existing issue for the --background alias omission. The closest --bg match is #64272, which is about hook payloads and unrelated.