{
  "name": "claude",
  "description": "Claude Code — interactive coding agent CLI",
  "options": [
    {
      "names": [
        "--add-dir"
      ],
      "description": "Additional directories to allow tool access to",
      "args": [
        {
          "name": "directories",
          "isVariadic": true,
          "template": "folders"
        }
      ]
    },
    {
      "names": [
        "--agent"
      ],
      "description": "Agent for the current session (overrides 'agent' setting)",
      "args": [
        {
          "name": "agent"
        }
      ]
    },
    {
      "names": [
        "--agents"
      ],
      "description": "JSON object defining custom agents",
      "args": [
        {
          "name": "json"
        }
      ]
    },
    {
      "names": [
        "--allow-dangerously-skip-permissions"
      ],
      "description": "Make bypass-permissions mode available (without defaulting to it)",
      "isDangerous": true
    },
    {
      "names": [
        "--allowedTools",
        "--allowed-tools"
      ],
      "description": "Comma/space-separated list of tool names to allow (e.g. \"Bash(git *) Edit\")",
      "args": [
        {
          "name": "tools",
          "isVariadic": true
        }
      ]
    },
    {
      "names": [
        "--append-system-prompt"
      ],
      "description": "Append a system prompt to the default system prompt",
      "args": [
        {
          "name": "prompt"
        }
      ]
    },
    {
      "names": [
        "--bare"
      ],
      "description": "Minimal mode: skip hooks, LSP, plugins, attribution, auto-memory, etc."
    },
    {
      "names": [
        "--betas"
      ],
      "description": "Beta headers to include in API requests (API key users only)",
      "args": [
        {
          "name": "betas",
          "isVariadic": true
        }
      ]
    },
    {
      "names": [
        "--brief"
      ],
      "description": "Enable SendUserMessage tool for agent-to-user communication"
    },
    {
      "names": [
        "--chrome"
      ],
      "description": "Enable Claude in Chrome integration"
    },
    {
      "names": [
        "-c",
        "--continue"
      ],
      "description": "Continue the most recent conversation in the current directory"
    },
    {
      "names": [
        "--dangerously-skip-permissions"
      ],
      "description": "Bypass all permission checks",
      "isDangerous": true
    },
    {
      "names": [
        "-d",
        "--debug"
      ],
      "description": "Enable debug mode with optional category filtering (e.g. \"api,hooks\")",
      "args": [
        {
          "name": "filter",
          "isOptional": true
        }
      ]
    },
    {
      "names": [
        "--debug-file"
      ],
      "description": "Write debug logs to a specific file path (implicitly enables debug mode)",
      "args": [
        {
          "name": "path",
          "template": "filepaths"
        }
      ]
    },
    {
      "names": [
        "--disable-slash-commands"
      ],
      "description": "Disable all skills"
    },
    {
      "names": [
        "--disallowedTools",
        "--disallowed-tools"
      ],
      "description": "Comma/space-separated list of tool names to deny (e.g. \"Bash(git *) Edit\")",
      "args": [
        {
          "name": "tools",
          "isVariadic": true
        }
      ]
    },
    {
      "names": [
        "--effort"
      ],
      "description": "Effort level for the current session",
      "args": [
        {
          "name": "level",
          "suggestions": [
            "low",
            "medium",
            "high",
            "xhigh",
            "max"
          ]
        }
      ]
    },
    {
      "names": [
        "--exclude-dynamic-system-prompt-sections"
      ],
      "description": "Move per-machine sections out of the system prompt for cache reuse"
    },
    {
      "names": [
        "--fallback-model"
      ],
      "description": "Enable automatic fallback to specified model when default is overloaded",
      "args": [
        {
          "name": "model"
        }
      ]
    },
    {
      "names": [
        "--file"
      ],
      "description": "File resources to download at startup (format: file_id:relative_path)",
      "args": [
        {
          "name": "specs",
          "isVariadic": true
        }
      ]
    },
    {
      "names": [
        "--fork-session"
      ],
      "description": "When resuming, create a new session ID instead of reusing the original"
    },
    {
      "names": [
        "--from-pr"
      ],
      "description": "Resume a session linked to a PR by PR number/URL (or interactive picker)",
      "args": [
        {
          "name": "value",
          "isOptional": true
        }
      ]
    },
    {
      "names": [
        "-h",
        "--help"
      ],
      "description": "Display help for command"
    },
    {
      "names": [
        "--ide"
      ],
      "description": "Automatically connect to IDE on startup if exactly one is available"
    },
    {
      "names": [
        "--include-hook-events"
      ],
      "description": "Include all hook lifecycle events in the output stream"
    },
    {
      "names": [
        "--include-partial-messages"
      ],
      "description": "Include partial message chunks as they arrive"
    },
    {
      "names": [
        "--input-format"
      ],
      "description": "Input format (only with --print)",
      "args": [
        {
          "name": "format",
          "suggestions": [
            "text",
            "stream-json"
          ]
        }
      ]
    },
    {
      "names": [
        "--json-schema"
      ],
      "description": "JSON Schema for structured output validation",
      "args": [
        {
          "name": "schema"
        }
      ]
    },
    {
      "names": [
        "--max-budget-usd"
      ],
      "description": "Maximum dollar amount to spend on API calls (only with --print)",
      "args": [
        {
          "name": "amount"
        }
      ]
    },
    {
      "names": [
        "--mcp-config"
      ],
      "description": "Load MCP servers from JSON files or strings (space-separated)",
      "args": [
        {
          "name": "configs",
          "isVariadic": true,
          "template": "filepaths"
        }
      ]
    },
    {
      "names": [
        "--mcp-debug"
      ],
      "description": "[DEPRECATED — use --debug] Enable MCP debug mode",
      "hidden": true
    },
    {
      "names": [
        "--model"
      ],
      "description": "Model for the current session (alias like 'sonnet'/'opus' or full name)",
      "args": [
        {
          "name": "model"
        }
      ]
    },
    {
      "names": [
        "-n",
        "--name"
      ],
      "description": "Set a display name for this session",
      "args": [
        {
          "name": "name"
        }
      ]
    },
    {
      "names": [
        "--no-chrome"
      ],
      "description": "Disable Claude in Chrome integration"
    },
    {
      "names": [
        "--no-session-persistence"
      ],
      "description": "Disable session persistence (only with --print)"
    },
    {
      "names": [
        "--output-format"
      ],
      "description": "Output format (only with --print)",
      "args": [
        {
          "name": "format",
          "suggestions": [
            "text",
            "json",
            "stream-json"
          ]
        }
      ]
    },
    {
      "names": [
        "--permission-mode"
      ],
      "description": "Permission mode for the session",
      "args": [
        {
          "name": "mode",
          "suggestions": [
            "acceptEdits",
            "auto",
            "bypassPermissions",
            "default",
            "dontAsk",
            "plan"
          ]
        }
      ]
    },
    {
      "names": [
        "--plugin-dir"
      ],
      "description": "Load a plugin from a directory or .zip for this session only",
      "isRepeatable": -1,
      "args": [
        {
          "name": "path",
          "template": "folders"
        }
      ]
    },
    {
      "names": [
        "--plugin-url"
      ],
      "description": "Fetch a plugin .zip from a URL for this session only",
      "isRepeatable": -1,
      "args": [
        {
          "name": "url"
        }
      ]
    },
    {
      "names": [
        "-p",
        "--print"
      ],
      "description": "Print response and exit (useful for pipes)"
    },
    {
      "names": [
        "--remote-control"
      ],
      "description": "Start an interactive session with Remote Control enabled",
      "args": [
        {
          "name": "name",
          "isOptional": true
        }
      ]
    },
    {
      "names": [
        "--remote-control-session-name-prefix"
      ],
      "description": "Prefix for auto-generated Remote Control session names",
      "args": [
        {
          "name": "prefix"
        }
      ]
    },
    {
      "names": [
        "--replay-user-messages"
      ],
      "description": "Re-emit user messages from stdin back on stdout for acknowledgment"
    },
    {
      "names": [
        "-r",
        "--resume"
      ],
      "description": "Resume a conversation by session ID, or open interactive picker",
      "args": [
        {
          "name": "value",
          "isOptional": true
        }
      ]
    },
    {
      "names": [
        "--session-id"
      ],
      "description": "Use a specific session ID (must be a valid UUID)",
      "args": [
        {
          "name": "uuid"
        }
      ]
    },
    {
      "names": [
        "--setting-sources"
      ],
      "description": "Comma-separated list of setting sources (user, project, local)",
      "args": [
        {
          "name": "sources"
        }
      ]
    },
    {
      "names": [
        "--settings"
      ],
      "description": "Path to a settings JSON file, or a JSON string",
      "args": [
        {
          "name": "file-or-json",
          "template": "filepaths"
        }
      ]
    },
    {
      "names": [
        "--strict-mcp-config"
      ],
      "description": "Only use MCP servers from --mcp-config"
    },
    {
      "names": [
        "--system-prompt"
      ],
      "description": "System prompt to use for the session",
      "args": [
        {
          "name": "prompt"
        }
      ]
    },
    {
      "names": [
        "--tmux"
      ],
      "description": "Create a tmux session for the worktree (requires --worktree)"
    },
    {
      "names": [
        "--tools"
      ],
      "description": "Specify the built-in tools to enable (e.g. \"Bash,Edit,Read\", \"default\", or \"\")",
      "args": [
        {
          "name": "tools",
          "isVariadic": true
        }
      ]
    },
    {
      "names": [
        "--verbose"
      ],
      "description": "Override verbose mode setting from config"
    },
    {
      "names": [
        "-v",
        "--version"
      ],
      "description": "Output the version number"
    },
    {
      "names": [
        "-w",
        "--worktree"
      ],
      "description": "Create a new git worktree for this session",
      "args": [
        {
          "name": "name",
          "isOptional": true
        }
      ]
    }
  ],
  "args": [
    {
      "name": "prompt",
      "description": "Your prompt (positional; consumed when no subcommand matches)",
      "isOptional": true
    }
  ],
  "subcommands": [
    {
      "name": "agents",
      "description": "Manage background agents",
      "options": [
        {
          "names": [
            "--add-dir"
          ],
          "description": "Additional directory to allow tool access in dispatched sessions (repeatable)",
          "isRepeatable": -1,
          "args": [
            {
              "name": "directory",
              "template": "folders"
            }
          ]
        },
        {
          "names": [
            "--allow-dangerously-skip-permissions"
          ],
          "description": "Make bypass-permissions mode available",
          "isDangerous": true
        },
        {
          "names": [
            "--cwd"
          ],
          "description": "Show only background sessions started under <path>",
          "args": [
            {
              "name": "path",
              "template": "folders"
            }
          ]
        },
        {
          "names": [
            "--dangerously-skip-permissions"
          ],
          "description": "Alias for --permission-mode bypassPermissions",
          "isDangerous": true
        },
        {
          "names": [
            "--effort"
          ],
          "description": "Default effort level for dispatched sessions",
          "args": [
            {
              "name": "level",
              "suggestions": [
                "low",
                "medium",
                "high",
                "xhigh",
                "max"
              ]
            }
          ]
        },
        {
          "names": [
            "--json"
          ],
          "description": "Print live sessions as a JSON array and exit"
        },
        {
          "names": [
            "--mcp-config"
          ],
          "description": "MCP server config to apply to dispatched sessions",
          "isRepeatable": -1,
          "args": [
            {
              "name": "config",
              "template": "filepaths"
            }
          ]
        },
        {
          "names": [
            "--model"
          ],
          "description": "Default model for dispatched sessions",
          "args": [
            {
              "name": "model"
            }
          ]
        },
        {
          "names": [
            "--permission-mode"
          ],
          "description": "Default permission mode for dispatched sessions",
          "args": [
            {
              "name": "mode",
              "suggestions": [
                "acceptEdits",
                "auto",
                "bypassPermissions",
                "default",
                "dontAsk",
                "plan"
              ]
            }
          ]
        },
        {
          "names": [
            "--plugin-dir"
          ],
          "description": "Load plugins from directory for agent view and dispatched sessions",
          "isRepeatable": -1,
          "args": [
            {
              "name": "path",
              "template": "folders"
            }
          ]
        }
      ]
    },
    {
      "name": "auth",
      "description": "Manage authentication"
    },
    {
      "name": "auto-mode",
      "description": "Inspect auto mode classifier configuration"
    },
    {
      "name": "doctor",
      "description": "Check the health of your Claude Code auto-updater"
    },
    {
      "name": "install",
      "description": "Install Claude Code native build",
      "options": [
        {
          "names": [
            "--force"
          ],
          "description": "Force installation even if already installed"
        }
      ],
      "args": [
        {
          "name": "target",
          "description": "Version (stable, latest, or specific)",
          "isOptional": true
        }
      ]
    },
    {
      "name": "mcp",
      "description": "Configure and manage MCP servers",
      "subcommands": [
        {
          "name": "add",
          "description": "Add an MCP server to Claude Code",
          "options": [
            {
              "names": [
                "-t",
                "--transport"
              ],
              "description": "Transport type (stdio, sse, http)",
              "args": [
                {
                  "name": "transport",
                  "suggestions": [
                    "stdio",
                    "sse",
                    "http"
                  ]
                }
              ]
            },
            {
              "names": [
                "-s",
                "--scope"
              ],
              "description": "Scope (local, user, project)",
              "args": [
                {
                  "name": "scope",
                  "suggestions": [
                    "local",
                    "user",
                    "project"
                  ]
                }
              ]
            },
            {
              "names": [
                "-e",
                "--env"
              ],
              "description": "Environment variable (KEY=value), repeatable",
              "isRepeatable": -1,
              "args": [
                {
                  "name": "KEY=value"
                }
              ]
            },
            {
              "names": [
                "-H",
                "--header"
              ],
              "description": "HTTP header (KEY: value), repeatable",
              "isRepeatable": -1,
              "args": [
                {
                  "name": "KEY: value"
                }
              ]
            }
          ],
          "args": [
            {
              "name": "name"
            },
            {
              "name": "commandOrUrl"
            },
            {
              "name": "args",
              "isOptional": true,
              "isVariadic": true
            }
          ]
        },
        {
          "name": "add-from-claude-desktop",
          "description": "Import MCP servers from Claude Desktop (Mac/WSL)"
        },
        {
          "name": "add-json",
          "description": "Add an MCP server with a JSON string",
          "args": [
            {
              "name": "name"
            },
            {
              "name": "json"
            }
          ]
        },
        {
          "name": "get",
          "description": "Get details about an MCP server",
          "args": [
            {
              "name": "name"
            }
          ]
        },
        {
          "name": "list",
          "description": "List configured MCP servers"
        },
        {
          "name": "remove",
          "description": "Remove an MCP server",
          "options": [
            {
              "names": [
                "-s",
                "--scope"
              ],
              "description": "Scope",
              "args": [
                {
                  "name": "scope",
                  "suggestions": [
                    "local",
                    "user",
                    "project"
                  ]
                }
              ]
            }
          ],
          "args": [
            {
              "name": "name"
            }
          ]
        },
        {
          "name": "reset-project-choices",
          "description": "Reset all approved/rejected project-scoped servers"
        },
        {
          "name": "serve",
          "description": "Start the Claude Code MCP server"
        },
        {
          "name": "help",
          "description": "Display help for command",
          "args": [
            {
              "name": "command",
              "isOptional": true
            }
          ]
        }
      ]
    },
    {
      "name": "plugin",
      "aliases": [
        "plugins"
      ],
      "description": "Manage Claude Code plugins",
      "subcommands": [
        {
          "name": "details",
          "description": "Show a plugin's component inventory and token cost",
          "args": [
            {
              "name": "name"
            }
          ]
        },
        {
          "name": "disable",
          "description": "Disable an enabled plugin",
          "args": [
            {
              "name": "plugin",
              "isOptional": true
            }
          ]
        },
        {
          "name": "enable",
          "description": "Enable a disabled plugin",
          "args": [
            {
              "name": "plugin"
            }
          ]
        },
        {
          "name": "install",
          "aliases": [
            "i"
          ],
          "description": "Install a plugin from available marketplaces",
          "args": [
            {
              "name": "plugin"
            }
          ]
        },
        {
          "name": "list",
          "description": "List installed plugins"
        },
        {
          "name": "marketplace",
          "description": "Manage Claude Code marketplaces"
        },
        {
          "name": "prune",
          "aliases": [
            "autoremove"
          ],
          "description": "Remove auto-installed dependencies no longer needed"
        },
        {
          "name": "tag",
          "description": "Create a {name}--v{version} git tag for a plugin release",
          "args": [
            {
              "name": "path",
              "isOptional": true,
              "template": "folders"
            }
          ]
        },
        {
          "name": "uninstall",
          "aliases": [
            "remove"
          ],
          "description": "Uninstall an installed plugin",
          "args": [
            {
              "name": "plugin"
            }
          ]
        },
        {
          "name": "update",
          "description": "Update a plugin to the latest version",
          "args": [
            {
              "name": "plugin"
            }
          ]
        },
        {
          "name": "validate",
          "description": "Validate a plugin or marketplace manifest",
          "args": [
            {
              "name": "path",
              "template": "folders"
            }
          ]
        },
        {
          "name": "help",
          "description": "Display help for command",
          "args": [
            {
              "name": "command",
              "isOptional": true
            }
          ]
        }
      ]
    },
    {
      "name": "project",
      "description": "Manage Claude Code project state"
    },
    {
      "name": "setup-token",
      "description": "Set up a long-lived authentication token (requires Claude subscription)"
    },
    {
      "name": "ultrareview",
      "description": "Run a cloud-hosted multi-agent code review of the current branch (or PR / base branch)",
      "args": [
        {
          "name": "target",
          "description": "PR number, URL, or base branch",
          "isOptional": true
        }
      ]
    },
    {
      "name": "update",
      "aliases": [
        "upgrade"
      ],
      "description": "Check for updates and install if available"
    }
  ]
}