[DOCS] CLI reference omits `--background` alias for background sessions

Open 💬 0 comments Opened Jun 23, 2026 by coygeek

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.

View original on GitHub ↗