chore: sync catalog with upstream docs

Auto-generated by .github/workflows/catalog-drift.yml.

Author: samkeen

catalog/cli-reference.json

@@ -1,8 +1,8 @@
 {
   "source": "https://code.claude.com/docs/en/cli-reference.md",
-  "fetchedAt": "2026-05-18T12:35:00.301Z",
-  "commandCount": 25,
-  "flagCount": 64,
+  "fetchedAt": "2026-06-08T13:09:24.510Z",
+  "commandCount": 27,
+  "flagCount": 66,
   "commands": [
     {
       "name": "cat file | claude -p \"query\"",
@@ -41,8 +41,8 @@
     },
     {
       "name": "claude agents",
-      "description": "Open [agent view](/en/agent-view) to monitor and dispatch parallel background sessions. Use `--cwd <path>` to show only sessions started under that directory",
-      "example": "`claude agents`"
+      "description": "Open [agent view](/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 live sessions as a JSON array for scripting. Pass `--permission-mode`, `--model`, `--effort`, or `--agent` to set [defaults for dispatched sessions](/en/agent-view#permission-mode-model-and-effort). Accepts `--settings`, `--add-dir`, `--plugin-dir`, and `--mcp-config` like the top-level `claude` command. Opening agent view requires an interactive terminal",
+      "example": "`claude agents --json`"
     },
     {
       "name": "claude attach <id>",
@@ -69,6 +69,16 @@
       "description": "Print the built-in [auto mode](/en/permission-modes#eliminate-prompts-with-auto-mode) classifier rules as JSON. Use `claude auto-mode config` to see your effective config with settings applied",
       "example": "`claude auto-mode defaults > rules.json`"
     },
+    {
+      "name": "claude daemon status",
+      "description": "Print the background-session [supervisor's](/en/agent-view#the-supervisor-process) state, version, socket directory, and worker count for diagnostics. Exits 1 if the supervisor isn't running",
+      "example": "`claude daemon status`"
+    },
+    {
+      "name": "claude daemon stop --any",
+      "description": "Stop the background-session [supervisor](/en/agent-view#the-supervisor-process) and the sessions it hosts. Pass `--keep-workers` to leave background sessions running so the next supervisor reconnects to them. `--any` confirms stopping an on-demand supervisor, which is the default. Use this to recover from an [unresponsive supervisor](/en/agent-view#agent-view-says-the-background-service-did-not-respond)",
+      "example": "`claude daemon stop --any --keep-workers`"
+    },
     {
       "name": "claude install [version]",
       "description": "Install or reinstall the native binary. Accepts a version like `2.1.118`, or `stable` or `latest`. See [Install a specific version](/en/setup#install-a-specific-version)",
@@ -101,12 +111,12 @@
     },
     {
       "name": "claude respawn <id>",
-      "description": "Restart a stopped [background session](/en/agent-view#manage-sessions-from-the-shell) with its conversation intact. Use `--all` to restart every stopped session",
+      "description": "Restart a [background session](/en/agent-view#manage-sessions-from-the-shell), running or stopped, with its conversation intact. Use `--all` to restart every running session, e.g. to pick up an updated Claude Code binary",
       "example": "`claude respawn 7c5dcf5d`"
     },
     {
       "name": "claude rm <id>",
-      "description": "Remove a [background session](/en/agent-view#manage-sessions-from-the-shell) from the list",
+      "description": "Remove a [background session](/en/agent-view#manage-sessions-from-the-shell) from the list. The conversation transcript stays on your local machine, available through `claude --resume`",
       "example": "`claude rm 7c5dcf5d`"
     },
     {
@@ -178,7 +188,7 @@
     },
     {
       "name": "--bg",
-      "description": "Start the session as a [background agent](/en/agent-view) and return immediately. Prints the session ID and management commands. Combine with `--agent` to run a specific subagent",
+      "description": "Start the session as a [background agent](/en/agent-view) and return immediately. Prints the session ID and management commands. Combine with `--exec` to run a shell command as a background job instead of a Claude session, or with `--agent` to run a specific subagent",
       "example": "`claude --bg \"investigate the flaky test\"`"
     },
     {
@@ -218,7 +228,7 @@
     },
     {
       "name": "--disallowedTools",
-      "description": "Tools that are removed from the model's context and cannot be used",
+      "description": "Deny rules. A bare tool name removes that tool from the model's context. A scoped rule such as `Bash(rm *)` leaves the tool available and denies only matching calls",
       "example": "`\"Bash(git log *)\" \"Bash(git diff *)\" \"Edit\"`"
     },
     {
@@ -236,9 +246,14 @@
       "description": "Move per-machine sections from the system prompt (working directory, environment info, memory paths, git-repo flag) into the first user message. Improves prompt-cache reuse across different users and machines running the same task. Only applies with the default system prompt; ignored when `--system-prompt` or `--system-prompt-file` is set. Use with `-p` for scripted, multi-user workloads",
       "example": "`claude -p --exclude-dynamic-system-prompt-sections \"query\"`"
     },
+    {
+      "name": "--exec",
+      "description": "Run a shell command as a PTY-backed background job instead of starting a Claude session. Use with `--bg` to launch from the shell",
+      "example": "`claude --bg --exec 'pytest -x'`"
+    },
     {
       "name": "--fallback-model",
-      "description": "Enable automatic fallback to specified model when default model is overloaded (print mode only)",
+      "description": "Enable automatic fallback to a specified model when the default model is overloaded or not available, for example a retired model. Takes effect in print mode (`-p`) and in [background sessions](/en/agent-view), which run non-interactively; ignored in an interactive session",
       "example": "`claude -p --fallback-model sonnet \"query\"`"
     },
     {
@@ -259,12 +274,12 @@
     {
       "name": "--include-hook-events",
       "description": "Include all hook lifecycle events in the output stream. Requires `--output-format stream-json`",
-      "example": "`claude -p --output-format stream-json --include-hook-events \"query\"`"
+      "example": "`claude -p --output-format stream-json --verbose --include-hook-events \"query\"`"
     },
     {
       "name": "--include-partial-messages",
       "description": "Include partial streaming events in output. Requires `--print` and `--output-format stream-json`",
-      "example": "`claude -p --output-format stream-json --include-partial-messages \"query\"`"
+      "example": "`claude -p --output-format stream-json --verbose --include-partial-messages \"query\"`"
     },
     {
       "name": "--init",
@@ -346,6 +361,11 @@
       "description": "Fetch a plugin `.zip` archive from a URL for this session only. Repeat the flag for multiple plugins, or pass space-separated URLs in a single quoted value",
       "example": "`claude --plugin-url https://example.com/plugin.zip`"
     },
+    {
+      "name": "--prompt-suggestions",
+      "description": "Emit a `prompt_suggestion` message after each turn with a predicted next user prompt. Requires `--print`, `--output-format stream-json`, and `--verbose`. See [Prompt suggestions](/en/interactive-mode#prompt-suggestions)",
+      "example": "`claude -p --prompt-suggestions --output-format stream-json --verbose \"query\"`"
+    },
     {
       "name": "--remote",
       "description": "Create a new [web session](/en/claude-code-on-the-web) on claude.ai with the provided task description",
@@ -359,7 +379,7 @@
     {
       "name": "--replay-user-messages",
       "description": "Re-emit user messages from stdin back on stdout for acknowledgment. Requires `--input-format stream-json` and `--output-format stream-json`",
-      "example": "`claude -p --input-format stream-json --output-format stream-json --replay-user-messages`"
+      "example": "`claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages`"
     },
     {
       "name": "--session-id",
@@ -438,7 +458,7 @@
     },
     {
       "name": "`--resume`, `-r`",
-      "description": "Resume a specific session by ID or name, or show an interactive picker to choose a session. Includes sessions that added this directory with `/add-dir`",
+      "description": "Resume a specific session by ID or name, or show an interactive picker to choose a session. Includes sessions that added this directory with `/add-dir`. As of v2.1.144, [background sessions](/en/agent-view) appear in the picker marked with `bg`",
       "example": "`claude --resume auth-refactor`"
     },
     {