[DOCS] `agent-view` docs omit `claude agents --dangerously-skip-permissions` as a dispatch default
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/agent-view
Section/Topic
"Permission mode, model, and effort" in the agent view guide
Current Documentation
The docs currently say:
To set defaults for every session you dispatch from agent view, pass any of--permission-mode,--model, or--effortwhen opening it: ``bash claude agents --permission-mode plan --model opus --effort high``
And later:
UsingbypassPermissionsorautois refused until you have accepted that mode by runningclaudewith it once interactively, since those modes let a session you aren't watching act without approval. The same applies whether you pass the mode toclaude agentsor toclaude --bg --permission-mode.
What's Wrong or Missing?
The page documents the new claude agents defaults for --permission-mode, --model, and --effort, but it does not document the parallel --dangerously-skip-permissions flag from v2.1.143 even though the changelog says agent view accepts it to set defaults for dispatched sessions.
That leaves a specific gap in the same section that explains dispatch defaults:
A. The direct bypass flag is omitted from the documented agent-view defaults
Readers are told they can preconfigure dispatched sessions with --permission-mode, --model, and --effort, but not that claude agents --dangerously-skip-permissions also sets the default permission behavior for sessions launched from the view.
B. The current wording only implies bypass mode indirectly
The note about bypassPermissions being refused until previously accepted suggests some claude agents mode support exists, but it does not explicitly document the direct flag users would search for from the changelog or from the main CLI flag reference.
Suggested Improvement
Update the "Permission mode, model, and effort" section to explicitly include --dangerously-skip-permissions as an agent-view dispatch default.
For example:
Before:
To set defaults for every session you dispatch from agent view, pass any of--permission-mode,--model, or--effortwhen opening it:
After:
To set defaults for every session you dispatch from agent view, pass--permission-mode,--model,--effort, or--dangerously-skip-permissionswhen opening it.
If the intended behavior is that --dangerously-skip-permissions is equivalent to --permission-mode bypassPermissions for sessions dispatched from agent view, say that explicitly and add a concrete claude agents --dangerously-skip-permissions example.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/agent-view | 304-324 | Agent view explains dispatch defaults for --permission-mode, --model, and --effort, but omits --dangerously-skip-permissions |
| https://code.claude.com/docs/en/cli-reference | 52-68, 90 | CLI reference documents both --dangerously-skip-permissions and the related permission flags, which highlights the missing agent-view cross-reference |
Total scope: 2 pages affected
Version context: The v2.1.143 changelog says claude agents accepts --permission-mode, --model, --effort, and --dangerously-skip-permissions to set defaults for sessions dispatched from the view.
3 Comments
Found 1 possible duplicate issue:
This issue will be automatically closed as a duplicate in 3 days.
🤖 Generated with Claude Code
Issue #59589 Verification
Title: [DOCS]
agent-viewdocs omitclaude agents --dangerously-skip-permissionsas a dispatch defaultIssue Date: 2026-05-16
Verification Date: 2026-05-22
Status: RESOLVED
---
Issue Summary
This issue reports that the agent view guide documented
claude agentsdispatch defaults for--permission-mode,--model, and--effort, but omitted the parallel--dangerously-skip-permissionsflag even though the changelog said agent view accepts it to set defaults for dispatched sessions.---
Verification Results
Claim 1: The agent view guide omits
--dangerously-skip-permissionsfrom dispatch-default documentationStatus: RESOLVED
At https://code.claude.com/docs/en/agent-view, lines 357-363 now document the defaults section and explicitly add the direct bypass flag. Line 363 states: "
claude agentsalso accepts--dangerously-skip-permissionsas shorthand for--permission-mode bypassPermissions, and--allow-dangerously-skip-permissionsto makebypassPermissionsavailable in each dispatched session'sShift+Tabcycle without starting in that mode."Verdict: The reported omission is no longer present. The agent view guide now names
--dangerously-skip-permissionsdirectly and explains its relationship to--permission-mode bypassPermissions.---
Claim 2: The old wording only implied bypass support indirectly
Status: RESOLVED
At https://code.claude.com/docs/en/agent-view, lines 363-366 now explicitly document both the direct flag and version requirements. The note at line 366 includes
--dangerously-skip-permissionsin the set ofclaude agentsflags that require the newer Claude Code versions.Verdict: The page no longer relies only on the later
bypassPermissionsacceptance note. It now explicitly documents the direct flag users would search for.---
Claim 3: The equivalent top-level CLI flag behavior should be clear
Status: RESOLVED
At https://code.claude.com/docs/en/agent-view, line 363 says
--dangerously-skip-permissionsis shorthand for--permission-mode bypassPermissionsand links to the top-level CLI flags. At https://code.claude.com/docs/en/cli-reference, line 64 documents--dangerously-skip-permissionsas equivalent to--permission-mode bypassPermissions, while line 91 documents the accepted--permission-modevalues includingbypassPermissions.Verdict: The relationship between the direct flag and permission mode is now explicit in the affected agent view section and corroborated by the CLI reference.
---
Current State
| Claim | Status |
|-------|--------|
| Agent view defaults omit
--dangerously-skip-permissions| RESOLVED || Bypass support is only implied indirectly | RESOLVED |
| Equivalence with
--permission-mode bypassPermissionsis unclear | RESOLVED |---
Suggested Fix
N/A - issue has been resolved.
---
References
--dangerously-skip-permissionsforclaude agentsand explains that it is shorthand for--permission-mode bypassPermissions.--dangerously-skip-permissionsamong theclaude agentsdispatch-default flags.--dangerously-skip-permissionsand the equivalent--permission-mode bypassPermissionsbehavior.---
Conclusion & Recommendation
Primary Concern: The agent view guide did not explicitly document
claude agents --dangerously-skip-permissionsas a dispatch-default flag.Resolution Status: RESOLVED
Recommendation: CLOSE
The current live documentation explicitly documents
--dangerously-skip-permissionsin the agent view dispatch-default section and explains that it is shorthand for--permission-mode bypassPermissions. The issue can be closed.---
This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.