[DOCS] Auto mode configuration guide missing `claude auto-mode reset`

Status Fixed / completed
Reported on v2.1.212
Maintainer reply None cached
Activity 1 comment · opened Jul 17, 2026 · closed Aug 17, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/auto-mode-config

Section/Topic

“Inspect the defaults and your effective config” and the claude auto-mode command reference.

Current Documentation

The guide currently says:

“Three CLI subcommands help you inspect and validate your configuration.”

It documents claude auto-mode defaults, claude auto-mode config, and claude auto-mode critique, but there is no reset command in the command examples or surrounding explanation.

What's Wrong or Missing?

Claude Code 2.1.212 adds claude auto-mode reset, which restores the default auto-mode configuration. The command has a confirmation prompt and accepts --yes to skip that prompt. The configuration reference does not mention the command, what it resets, or how the confirmation behaves.

Administrators and developers who experiment with custom auto-mode rules have no documented recovery path for returning to the built-in configuration. They may incorrectly edit settings by hand or assume that defaults changes the active configuration.

Suggested Improvement

Add claude auto-mode reset to the command reference with examples such as:

claude auto-mode reset
claude auto-mode reset --yes

Explain that defaults only prints the built-in rules, while reset restores the default auto-mode configuration, and document the confirmation prompt and the non-interactive --yes option.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/auto-mode-config | Configuration and command reference |
| https://code.claude.com/docs/en/commands | User-facing command discovery, if auto-mode commands are indexed there |

Total scope: 2 pages should either document the command directly or link to its reference.

The command was added in Claude Code 2.1.212; the release notes are listed at https://code.claude.com/docs/en/changelog.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗