The helper that reconstructs a --permission-mode CLI flag for a resumed or replayed session now recognizes default, plan, dontAsk, and bubble, in addition to the previously supported bypassPermissions, acceptEdits, and auto. Sessions using these modes now round-trip correctly when replayed.
Names in the bundle--permission-mode
The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.
Added since
A small documentation edit on Week 20 · May 11–15, 2026 touched a line naming --permission-mode after this was published.
<div><code>claude agents</code> gained dispatch flags (`--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`) to configure background sessions, and `claude a…whats-new/2026-w20 see the edit
Confirmed since
Anthropic's documentation has since written up --permission-mode, on CLI reference.
| `claude agents` | Open [agent view](/docs/en/agent-view) to monitor and dispatch parallel background sessions. Use `--cwd <path>` to show only sessions started under that directory, or `--json` to print active sessions as a JSON array fo…cli-reference see the edit
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agrees
Anthropic's documentation has since written up --permission-mode, on CLI reference.