chore: sync catalog with upstream docs

catalog/cli-reference.json

@@ -1,7 +1,7 @@
 {
   "source": "https://code.claude.com/docs/en/cli-reference.md",
-  "fetchedAt": "2026-05-18T12:35:00.301Z",
-  "commandCount": 25,
+  "fetchedAt": "2026-05-25T12:34:19.315Z",
+  "commandCount": 26,
   "flagCount": 64,
   "commands": [
     {
@@ -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`, or `--effort` 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,11 @@
       "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 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 +106,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`"
     },
     {
@@ -218,7 +223,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\"`"
     },
     {
@@ -238,7 +243,7 @@
     },
     {
       "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. 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\"`"
     },
     {
@@ -438,7 +443,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`"
     },
     {

catalog/hooks.json

@@ -1,6 +1,6 @@
 {
   "source": "https://code.claude.com/docs/en/hooks.md",
-  "fetchedAt": "2026-05-18T12:34:58.886Z",
+  "fetchedAt": "2026-05-25T12:34:17.888Z",
   "count": 29,
   "events": [
     {
@@ -102,7 +102,7 @@
       "name": "Notification",
       "when": "When Claude Code sends a notification",
       "inputFields": [],
-      "inputExample": "{\n  \"session_id\": \"abc123\",\n  \"transcript_path\": \"/Users/.../.claude/projects/.../00893aaf-19fa-41d2-8238-13269b9b3ca0.jsonl\",\n  \"cwd\": \"/Users/...\",\n  \"hook_event_name\": \"Notification\",\n  \"message\": \"Claude needs your permission to use Bash\",\n  \"title\": \"Permission needed\",\n  \"notification_type\": \"permission_prompt\"\n}",
+      "inputExample": "{\n  \"session_id\": \"abc123\",\n  \"transcript_path\": \"/Users/.../.claude/projects/.../00893aaf-19fa-41d2-8238-13269b9b3ca0.jsonl\",\n  \"cwd\": \"/Users/...\",\n  \"hook_event_name\": \"Notification\",\n  \"message\": \"Claude needs your permission\",\n  \"title\": \"Permission needed\",\n  \"notification_type\": \"permission_prompt\"\n}",
       "outputFields": []
     },
     {
@@ -269,6 +269,14 @@
         {
           "field": "additionalContext",
           "description": "String added to Claude's context at the start of the conversation, before the first prompt. See [Add context for Claude](#add-context-for-claude) for how the text is delivered and what to put in it"
+        },
+        {
+          "field": "initialUserMessage",
+          "description": "String used as the first user message of the session. Applies in [non-interactive mode](/en/headless) (`-p`), where it becomes the first turn even if no prompt is provided. If a prompt is provided, it follows as the next turn. Unlike `additionalContext`, which attaches to an existing turn, this creates the turn"
+        },
+        {
+          "field": "watchPaths",
+          "description": "Array of absolute paths to watch for [FileChanged](#filechanged) events during this session"
         }
       ]
     },
@@ -287,8 +295,45 @@
     {
       "name": "Stop",
       "when": "When Claude finishes responding",
-      "inputFields": [],
-      "inputExample": "{\n  \"session_id\": \"abc123\",\n  \"transcript_path\": \"~/.claude/projects/.../00893aaf-19fa-41d2-8238-13269b9b3ca0.jsonl\",\n  \"cwd\": \"/Users/...\",\n  \"permission_mode\": \"default\",\n  \"hook_event_name\": \"Stop\",\n  \"stop_hook_active\": true,\n  \"last_assistant_message\": \"I've completed the refactoring. Here's a summary...\"\n}",
+      "inputFields": [
+        {
+          "field": "id",
+          "description": "Task identifier"
+        },
+        {
+          "field": "type",
+          "description": "Friendly task-type label such as `shell`, `subagent`, `monitor`, `workflow`, `teammate`, `cloud session`, or `MCP task`. Each label identifies which Claude Code feature created the task. Falls back to the raw discriminant for unrecognized types"
+        },
+        {
+          "field": "status",
+          "description": "Current task status"
+        },
+        {
+          "field": "description",
+          "description": "Free-text description, capped at 1000 characters with an in-string `… [+N chars]` marker when clipped"
+        },
+        {
+          "field": "command",
+          "description": "Shell command line, capped at 1000 characters. Present only for `shell` tasks"
+        },
+        {
+          "field": "agent_type",
+          "description": "Subagent type name. Present only for `subagent` tasks"
+        },
+        {
+          "field": "server",
+          "description": "MCP server name. Present only for `monitor` and `MCP task` tasks"
+        },
+        {
+          "field": "tool",
+          "description": "MCP tool name. Present only for `monitor` and `MCP task` tasks"
+        },
+        {
+          "field": "name",
+          "description": "Workflow name. Present only for `workflow` tasks"
+        }
+      ],
+      "inputExample": "{\n  \"session_id\": \"abc123\",\n  \"transcript_path\": \"~/.claude/projects/.../00893aaf-19fa-41d2-8238-13269b9b3ca0.jsonl\",\n  \"cwd\": \"/Users/...\",\n  \"permission_mode\": \"default\",\n  \"hook_event_name\": \"Stop\",\n  \"stop_hook_active\": true,\n  \"last_assistant_message\": \"I've completed the refactoring. Here's a summary...\",\n  \"background_tasks\": [\n    {\n      \"id\": \"task-001\",\n      \"type\": \"shell\",\n      \"status\": \"running\",\n      \"description\": \"tail logs\",\n      \"command\": \"tail -f /var/log/syslog\"\n    }\n  ],\n  \"session_crons\": [\n    {\n      \"id\": \"cron-001\",\n      \"schedule\": \"0 9 * * 1-5\",\n      \"recurring\": true,\n      \"prompt\": \"check the build\"\n    }\n  ]\n}",
       "outputFields": [
         {
           "field": "decision",
@@ -306,7 +351,7 @@
       "inputFields": [
         {
           "field": "error",
-          "description": "Error type: `rate_limit`, `authentication_failed`, `oauth_org_not_allowed`, `billing_error`, `invalid_request`, `server_error`, `max_output_tokens`, or `unknown`"
+          "description": "Error type: `rate_limit`, `authentication_failed`, `oauth_org_not_allowed`, `billing_error`, `invalid_request`, `model_not_found`, `server_error`, `max_output_tokens`, or `unknown`"
         },
         {
           "field": "error_details",
@@ -336,7 +381,7 @@
       "name": "SubagentStop",
       "when": "When a subagent finishes",
       "inputFields": [],
-      "inputExample": "{\n  \"session_id\": \"abc123\",\n  \"transcript_path\": \"~/.claude/projects/.../abc123.jsonl\",\n  \"cwd\": \"/Users/...\",\n  \"permission_mode\": \"default\",\n  \"hook_event_name\": \"SubagentStop\",\n  \"stop_hook_active\": false,\n  \"agent_id\": \"def456\",\n  \"agent_type\": \"Explore\",\n  \"agent_transcript_path\": \"~/.claude/projects/.../abc123/subagents/agent-def456.jsonl\",\n  \"last_assistant_message\": \"Analysis complete. Found 3 potential issues...\"\n}",
+      "inputExample": "{\n  \"session_id\": \"abc123\",\n  \"transcript_path\": \"~/.claude/projects/.../abc123.jsonl\",\n  \"cwd\": \"/Users/...\",\n  \"permission_mode\": \"default\",\n  \"hook_event_name\": \"SubagentStop\",\n  \"stop_hook_active\": false,\n  \"agent_id\": \"def456\",\n  \"agent_type\": \"Explore\",\n  \"agent_transcript_path\": \"~/.claude/projects/.../abc123/subagents/agent-def456.jsonl\",\n  \"last_assistant_message\": \"Analysis complete. Found 3 potential issues...\",\n  \"background_tasks\": [],\n  \"session_crons\": []\n}",
       "outputFields": []
     },
     {
@@ -452,6 +497,10 @@
         {
           "field": "sessionTitle",
           "description": "Sets the session title. Use to name sessions automatically based on the prompt content"
+        },
+        {
+          "field": "suppressOriginalPrompt",
+          "description": "If `true` when `decision` is `\"block\"`, omits the original prompt text from the block message shown to the user"
         }
       ]
     },

catalog/keybindings.json

@@ -1,6 +1,6 @@
 {
   "source": "https://code.claude.com/docs/en/keybindings.md",
-  "fetchedAt": "2026-05-18T12:35:00.020Z",
+  "fetchedAt": "2026-05-25T12:34:19.029Z",
   "count": 20,
   "contexts": [
     {

catalog/mcp.json

@@ -1,6 +1,6 @@
 {
   "source": "https://code.claude.com/docs/en/mcp.md",
-  "fetchedAt": "2026-05-18T12:34:59.431Z",
+  "fetchedAt": "2026-05-25T12:34:18.488Z",
   "count": 3,
   "scopes": [
     {

catalog/model-config.json

@@ -1,6 +1,6 @@
 {
   "source": "https://code.claude.com/docs/en/model-config.md",
-  "fetchedAt": "2026-05-22T14:01:08.197Z",
+  "fetchedAt": "2026-05-25T12:34:19.585Z",
   "count": 5,
   "effortLevels": [
     {

catalog/permissions.json

@@ -1,6 +1,6 @@
 {
   "source": "https://code.claude.com/docs/en/permissions.md",
-  "fetchedAt": "2026-05-18T12:34:59.743Z",
+  "fetchedAt": "2026-05-25T12:34:18.753Z",
   "count": 6,
   "modes": [
     {