[DOCS] Auto mode docs missing denied-command notification and `/permissions` Recent tab

Resolved 💬 2 comments Opened Mar 31, 2026 by coygeek Closed Apr 9, 2026

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 tab

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗