[DOCS] Auto mode docs missing denied-command notification and `/permissions` Recent tab
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/permissions
Section/Topic
Manage permissions and the /permissions UI coverage for recent auto mode denials
Current Documentation
The permissions page currently says:
You can view and manage Claude Code's tool permissions with /permissions. This UI lists all permission rules and the settings.json file they are sourced from. Allow rules let Claude Code use the specified tool without manual approval. Ask rules prompt for confirmation whenever Claude Code tries to use the specified tool. * Deny rules prevent Claude Code from using the specified tool.
The auto mode page currently says:
If the classifier blocks an action 3 times in a row or 20 times total in one session, auto mode pauses and Claude Code resumes prompting for each action. These thresholds are not configurable. * CLI: you see a notification in the status area. Approving the prompted action resets the denial counters, so you can continue in auto mode
These pages do not document that individual auto mode denied commands now surface a notification and are recorded in /permissions -> Recent.
What's Wrong or Missing?
A. /permissions does not document the Recent tab
The main permissions page explains allow/ask/deny rules, but it does not mention that recent auto mode denials are visible in /permissions -> Recent. Users have no documented place to inspect a denied command after the moment it is blocked.
B. Auto mode denial visibility is only partially described
The auto mode page documents a notification when auto mode falls back after repeated classifier blocks, but it does not describe the v2.1.88 behavior where a denied command itself now shows a notification and appears in /permissions -> Recent.
This leaves the troubleshooting flow incomplete for users trying to understand why auto mode blocked a command, review recent denials, or decide whether they need to adjust trusted infrastructure or permission settings.
Suggested Improvement
Add a short subsection to https://code.claude.com/docs/en/permissions that documents the /permissions tabs, especially Recent, and explain that auto mode denied commands appear there with the denial also surfaced as a notification.
Also add a short note to https://code.claude.com/docs/en/permission-modes near auto mode block handling that clarifies:
When auto mode denies a command, Claude Code shows a notification and records the event in /permissions -> Recent so you can review recent blocks and decide whether to retry, adjust permissions, or update trusted infrastructure.
If you want this to be more discoverable, the /permissions entry in https://code.claude.com/docs/en/commands could also mention that it shows recent permission activity, not just saved rules.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/permissions | Primary /permissions documentation; should describe the Recent tab and recent auto mode denials |
| https://code.claude.com/docs/en/permission-modes | Auto mode behavior and block handling; currently mentions notification only when auto mode falls back after repeated blocks |
| https://code.claude.com/docs/en/commands | /permissions command reference; may need a short discoverability note about recent permission activity |
Total scope: 3 pages affected
Source: Changelog v2.1.88
Exact changelog entry:
Auto mode denied commands now show a notification and appear in /permissions -> Recent tabThis issue has 2 comments on GitHub. Read the full discussion on GitHub ↗