[DOCS] Missing Documentation for Various Claude Code Features (CLI Flags, Slash Commands, & Tools)

Documentation Type

Missing documentation (feature not documented)

Documentation Location

This is a general issue across the documentation, but primarily affects these pages: https://docs.claude.com/en/docs/claude-code/cli-reference https://docs.claude.com/en/docs/claude-code/slash-commands https://docs.claude.com/en/docs/claude-code/settings

Section/Topic

The reference tables for CLI flags, top-level commands, slash commands, and available tools are all missing key features that are present in the claude --help output, the interactive slash command list, and the internal system prompt.

Current Documentation

The current documentation provides tables for CLI flags, slash commands, and tools, but they are incomplete. For example, the cli-reference page lists many flags but omits several that appear in claude --help. Similarly, the slash-commands page is missing over a dozen commands available in the interactive REPL.

What's Wrong or Missing?

There are numerous features available to users that are not documented on docs.claude.com. This makes it difficult for users to discover and utilize the full capabilities of Claude Code.

Here is a comprehensive list of undocumented features found by comparing the official docs to the provided materials:

---

A. Undocumented CLI Flags & Commands

The following flags and commands appear in the claude --help output but are missing from the cli-reference documentation page.

Undocumented Flags:

• --debug [filter]: The --verbose flag is documented, but the more advanced --debug flag is not.
• --fallback-model <model>: A crucial flag for ensuring service reliability that is not mentioned.
• --strict-mcp-config: An important flag for controlling MCP server configuration that is missing.
• --replay-user-messages: A useful flag for scripting and SDK usage that is not documented in the main CLI reference.

Undocumented Top-Level Commands:

• claude migrate-installer: An important command for managing the installation method.
• claude setup-token: A command for authentication that is not documented.
• claude doctor: While the /doctor slash command is documented, the top-level claude doctor command is not mentioned in the CLI reference.

---

B. Undocumented Slash Commands

The following slash commands are visible in the interactive help menu but are missing from the documentation on the slash-commands page.

• /bashes: List and manage background tasks.
• /context: Visualize current context usage. Mentioned in changelog (1.0.86).
• /exit (and alias /quit): The primary way to exit the REPL.
• /export: Export the current conversation. Mentioned in changelog (1.0.44).
• /feedback: An alias for the documented /bug command.
• /hooks: Manage hook configurations.
• /ide: Manage IDE integrations.
• /install-github-app: Set up Claude GitHub Actions.
• /privacy-settings: View and update privacy settings.
• /release-notes: View release notes. Mentioned in changelog (0.2.37).
• /resume: Interactively resume a past conversation (distinct from the CLI flag).
• /todos: List current todo items. Mentioned in changelog (1.0.94).
• /upgrade: A command for users on subscription plans.

---

C. Undocumented Tools

The following tools are available to Claude (as defined in the internal system prompt and SDK docs) but are not listed in the "Tools available to Claude" table on the settings documentation page.

• BashOutput: Retrieves output from background bash processes. This is essential for using background commands effectively.
• ExitPlanMode: A core part of the "plan mode" workflow.
• KillBash / KillShell: The tool for terminating background processes. The SDK docs list KillBash, while the internal system prompt lists KillShell. This discrepancy should be clarified and the tool should be documented.
• TodoWrite: The internal system prompt heavily emphasizes the use of this tool for task management ("Use these tools VERY frequently"). While it is documented for the Agent SDK, its existence and importance for general CLI users are not mentioned in the main Claude Code docs.

Suggested Improvement

The documentation should be updated to be a complete and accurate reference for all available features.

1. Update cli-reference page: Add all missing flags and top-level commands to the tables with clear descriptions and examples.
2. Update slash-commands page: Add all missing slash commands to the table, explaining their function and any arguments they take.
3. Update settings page: Add all missing tools to the "Tools available to Claude" table, explaining their purpose and when Claude might use them. Clarify the KillBash/KillShell name discrepancy. Add a user-facing section explaining the TodoWrite tool and how it helps users track Claude's progress.

Impact

High - Prevents users from using a feature

Additional Context

• The discrepancy between the tool name KillShell in the internal system prompt and KillBash in the Python SDK documentation suggests a potential inconsistency that should be investigated and clarified in the documentation.
• The internal system prompt places a very high emphasis on the TodoWrite tool for task planning and user visibility. The lack of user-facing documentation for this feature is a significant gap, as users may not understand the "todo list" outputs they see in the terminal.
• The changelog often lists new features (like /context and /release-notes) that were never added to the main documentation, indicating a potential gap in the documentation update process.