cli.commands.json

{
  "about": "Cortex - AI Coding Agent",
  "arguments": [
    {
      "help": "Configuration overrides in the form key=value",
      "id": "raw_overrides",
      "long": "config",
      "required": false,
      "short": "c"
    },
    {
      "help": "Enable verbose output (same as --log-level debug)",
      "id": "verbose",
      "long": "verbose",
      "required": false,
      "short": "v"
    },
    {
      "help": "Enable trace-level logging for debugging",
      "id": "trace",
      "long": "trace",
      "required": false,
      "short": null
    },
    {
      "help": "Control color output: auto (default), always, or never",
      "id": "color",
      "long": "color",
      "required": false,
      "short": null
    },
    {
      "help": "Model to use (e.g., claude-sonnet-4-20250514, gpt-4o, gemini-2.0-flash)",
      "id": "model",
      "long": "model",
      "required": false,
      "short": "m"
    },
    {
      "help": "Use open-source/local LLM providers instead of cloud APIs",
      "id": "oss",
      "long": "oss",
      "required": false,
      "short": null
    },
    {
      "help": "Configuration profile from config.toml",
      "id": "config_profile",
      "long": "profile",
      "required": false,
      "short": "p"
    },
    {
      "help": "Select the sandbox policy for shell commands",
      "id": "sandbox_mode",
      "long": "sandbox",
      "required": false,
      "short": "s"
    },
    {
      "help": "Set the approval policy for tool executions",
      "id": "approval_policy",
      "long": "ask-for-approval",
      "required": false,
      "short": "a"
    },
    {
      "help": "Enable fully automatic mode with sandboxed execution",
      "id": "full_auto",
      "long": "full-auto",
      "required": false,
      "short": null
    },
    {
      "help": "Skip all confirmation prompts and execute commands without sandboxing. DANGEROUS!",
      "id": "dangerously_bypass_approvals_and_sandbox",
      "long": "dangerously-bypass-approvals-and-sandbox",
      "required": false,
      "short": null
    },
    {
      "help": "Tell the agent to use the specified directory as its working root",
      "id": "cwd",
      "long": "cd",
      "required": false,
      "short": "C"
    },
    {
      "help": "Additional directories that should be writable",
      "id": "add_dir",
      "long": "add-dir",
      "required": false,
      "short": null
    },
    {
      "help": "Image files to attach to the initial prompt",
      "id": "images",
      "long": "image",
      "required": false,
      "short": "i"
    },
    {
      "help": "Enable web search capability for the agent",
      "id": "web_search",
      "long": "search",
      "required": false,
      "short": null
    },
    {
      "help": "Enter the alternate screen buffer. Default is **always** (full viewport). Same as `[tui] alternate_screen = true`. Use `--no-alternate-screen` to stay inline",
      "id": "alternate_screen",
      "long": "alternate-screen",
      "required": false,
      "short": null
    },
    {
      "help": "Stay inline in the host terminal (never alternate screen). Same as `[tui] alternate_screen = false`",
      "id": "no_alternate_screen",
      "long": "no-alternate-screen",
      "required": false,
      "short": null
    },
    {
      "help": "Maximum number of concurrent agent threads",
      "id": "max_agent_threads",
      "long": "max-agent-threads",
      "required": false,
      "short": null
    },
    {
      "help": "Maximum number of concurrent tool executions",
      "id": "max_tool_threads",
      "long": "max-tool-threads",
      "required": false,
      "short": null
    },
    {
      "help": "Timeout for shell commands in seconds",
      "id": "command_timeout",
      "long": "command-timeout",
      "required": false,
      "short": null
    },
    {
      "help": "Timeout for HTTP requests in seconds",
      "id": "http_timeout",
      "long": "http-timeout",
      "required": false,
      "short": null
    },
    {
      "help": "Disable streaming responses",
      "id": "no_streaming",
      "long": "no-streaming",
      "required": false,
      "short": null
    },
    {
      "help": "Set log verbosity level (error, warn, info, debug, trace)",
      "id": "log_level",
      "long": "log-level",
      "required": false,
      "short": "L"
    },
    {
      "help": "Record private, content-free local diagnostics (never prompts or tool output)",
      "id": "debug",
      "long": "debug",
      "required": false,
      "short": null
    },
    {
      "help": "Initial prompt (if no subcommand)",
      "id": "prompt",
      "long": null,
      "required": false,
      "short": null
    },
    {
      "help": "Print help (see more with '--help')",
      "id": "help",
      "long": "help",
      "required": false,
      "short": "h"
    },
    {
      "help": "Print version",
      "id": "version",
      "long": "version",
      "required": false,
      "short": "V"
    }
  ],
  "name": "cortex",
  "subcommands": [
    {
      "about": "Run Cortex non-interactively with advanced options",
      "arguments": [
        {
          "help": "Message to send to the AI agent. Multiple arguments are joined with spaces. Note: Prompts starting with a dash (e.g., \"--help explain this flag\") are supported and won't be interpreted as flags",
          "id": "message",
          "long": null,
          "required": false,
          "short": null
        },
        {
          "help": "Execute a predefined command instead of a prompt. Use message arguments as command arguments",
          "id": "command",
          "long": "command",
          "required": false,
          "short": null
        },
        {
          "help": "Continue the most recent session",
          "id": "continue_session",
          "long": "continue",
          "required": false,
          "short": "c"
        },
        {
          "help": "Specify a session ID to continue",
          "id": "session_id",
          "long": "session",
          "required": false,
          "short": "s"
        },
        {
          "help": "Automatically share the session and print the share URL",
          "id": "share",
          "long": "share",
          "required": false,
          "short": null
        },
        {
          "help": "Model to use in provider/model format (e.g., anthropic/claude-3-5-sonnet)",
          "id": "model",
          "long": "model",
          "required": false,
          "short": "m"
        },
        {
          "help": "Agent to use for this request",
          "id": "agent",
          "long": "agent",
          "required": false,
          "short": null
        },
        {
          "help": "Output format: default (formatted), json, or jsonl",
          "id": "format",
          "long": "format",
          "required": false,
          "short": null
        },
        {
          "help": "Output format alias (same as --format). Valid values: default, json, jsonl",
          "id": "output",
          "long": "output",
          "required": false,
          "short": null
        },
        {
          "help": "File(s) to attach to the message. Can be specified multiple times",
          "id": "files",
          "long": "file",
          "required": false,
          "short": "f"
        },
        {
          "help": "Title for the session. If empty string is provided, uses truncated prompt",
          "id": "title",
          "long": "title",
          "required": false,
          "short": null
        },
        {
          "help": "Attach to a running Cortex server instead of starting locally. Value should be the server URL (e.g., \"http://localhost:3000\"). Use this to connect to a remote Cortex instance or an existing local server started with 'cortex serve'",
          "id": "attach",
          "long": "attach",
          "required": false,
          "short": null
        },
        {
          "help": "Port for the local server (defaults to random port)",
          "id": "port",
          "long": "port",
          "required": false,
          "short": null
        },
        {
          "help": "Model temperature (0.0-2.0). Lower values make output more deterministic",
          "id": "temperature",
          "long": "temperature",
          "required": false,
          "short": "t"
        },
        {
          "help": "Top-p (nucleus) sampling parameter. Controls diversity of token selection",
          "id": "top_p",
          "long": "top-p",
          "required": false,
          "short": null
        },
        {
          "help": "Top-k sampling parameter. Limits token selection to k most probable tokens. Note: Not all providers support combining --top-k with --temperature",
          "id": "top_k",
          "long": "top-k",
          "required": false,
          "short": null
        },
        {
          "help": "Random seed for reproducible outputs",
          "id": "seed",
          "long": "seed",
          "required": false,
          "short": null
        },
        {
          "help": "Send a desktop notification when the task completes",
          "id": "notification",
          "long": "notification",
          "required": false,
          "short": "n"
        },
        {
          "help": "Stream output as it arrives (default behavior). Use --no-stream to buffer and wait for the complete response",
          "id": "stream",
          "long": "stream",
          "required": false,
          "short": null
        },
        {
          "help": "Disable streaming - wait for complete response before outputting. This is the opposite of --stream (which is enabled by default)",
          "id": "no_stream",
          "long": "no-stream",
          "required": false,
          "short": null
        },
        {
          "help": "Copy the final AI response to the system clipboard",
          "id": "copy",
          "long": "copy",
          "required": false,
          "short": "C"
        },
        {
          "help": "Save the final response to a file. Parent directory will be created automatically if it doesn't exist",
          "id": "output_file",
          "long": "output-file",
          "required": false,
          "short": "o"
        },
        {
          "help": "Working directory override",
          "id": "cwd",
          "long": "cwd",
          "required": false,
          "short": null
        },
        {
          "help": "Additional directories that should be writable. Can be specified multiple times to add multiple directories",
          "id": "add_dir",
          "long": "add-dir",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose/debug output",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Timeout in seconds (0 for no timeout)",
          "id": "timeout",
          "long": "timeout",
          "required": false,
          "short": null
        },
        {
          "help": "Preview what would be sent without executing. Shows estimated token counts including system prompt and tool definitions",
          "id": "dry_run",
          "long": "dry-run",
          "required": false,
          "short": null
        },
        {
          "help": "Maximum tokens for response (used for token validation). If specified, cortex will validate that prompt + max_tokens does not exceed the model's context limit before making the API call",
          "id": "max_tokens",
          "long": "max-tokens",
          "required": false,
          "short": null
        },
        {
          "help": "Client instructions sent as additional user context, not a service system override",
          "id": "system_prompt",
          "long": "system",
          "required": false,
          "short": null
        },
        {
          "help": "Path to a JSON schema file for structured output. When provided, the AI response will be validated against this schema",
          "id": "schema",
          "long": "schema",
          "required": false,
          "short": null
        },
        {
          "help": "Suppress non-essential output (quiet mode). Only show the final result or errors",
          "id": "quiet",
          "long": "quiet",
          "required": false,
          "short": "q"
        },
        {
          "help": "Disable progress indicators (useful for CI/CD environments)",
          "id": "no_progress",
          "long": "no-progress",
          "required": false,
          "short": null
        },
        {
          "help": "Bypass any cached responses and force a fresh request",
          "id": "no_cache",
          "long": "no-cache",
          "required": false,
          "short": null
        },
        {
          "help": "Number of times to retry failed requests (default: 0)",
          "id": "retry",
          "long": "retry",
          "required": false,
          "short": null
        },
        {
          "help": "Frequency penalty (-2.0 to 2.0). Positive values penalize tokens based on their frequency in the text so far, decreasing the likelihood of repeating the same content verbatim",
          "id": "frequency_penalty",
          "long": "frequency-penalty",
          "required": false,
          "short": null
        },
        {
          "help": "Presence penalty (-2.0 to 2.0). Positive values penalize new tokens based on whether they appear in the text so far, increasing the likelihood of talking about new topics",
          "id": "presence_penalty",
          "long": "presence-penalty",
          "required": false,
          "short": null
        },
        {
          "help": "Stop sequences (can be specified multiple times). Generation will stop when any of these sequences is encountered",
          "id": "stop_sequences",
          "long": "stop",
          "required": false,
          "short": null
        },
        {
          "help": "Request log probabilities for output tokens. Returns the log probabilities of the most likely tokens (up to 5)",
          "id": "logprobs",
          "long": "logprobs",
          "required": false,
          "short": null
        },
        {
          "help": "Number of completions to generate. Returns multiple independent completions for the same prompt",
          "id": "num_completions",
          "long": "n",
          "required": false,
          "short": null
        },
        {
          "help": "Generate best_of completions and return the best one. Must be greater than n if n is specified",
          "id": "best_of",
          "long": "best-of",
          "required": false,
          "short": null
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "run",
      "subcommands": []
    },
    {
      "about": "Execute in headless mode (for CI/CD, scripts, automation)",
      "arguments": [
        {
          "help": "The prompt to execute. Can also be provided via stdin or --file. Prompts starting with a dash (e.g., \"--help explain this\") are supported",
          "id": "prompt",
          "long": null,
          "required": false,
          "short": null
        },
        {
          "help": "Read prompt from file",
          "id": "file",
          "long": "file",
          "required": false,
          "short": "f"
        },
        {
          "help": "Output format",
          "id": "output_format",
          "long": "output-format",
          "required": false,
          "short": "o"
        },
        {
          "help": "Input format (for multi-turn sessions)",
          "id": "input_format",
          "long": "input-format",
          "required": false,
          "short": null
        },
        {
          "help": "Autonomy level for operations. - read-only: No modifications (default, safest) - low/medium: Unsupported client risk thresholds for Code - high: Server-owned agent execution, subject to service permissions",
          "id": "autonomy",
          "long": "auto",
          "required": false,
          "short": null
        },
        {
          "help": "Unsupported for server-owned Code execution; fails before submission. Cannot be combined with --auto",
          "id": "skip_permissions",
          "long": "skip-permissions-unsafe",
          "required": false,
          "short": null
        },
        {
          "help": "Model ID to use",
          "id": "model",
          "long": "model",
          "required": false,
          "short": "m"
        },
        {
          "help": "Model ID to use for spec mode",
          "id": "spec_model",
          "long": "spec-model",
          "required": false,
          "short": null
        },
        {
          "help": "Start in specification mode (plan before executing)",
          "id": "use_spec",
          "long": "use-spec",
          "required": false,
          "short": null
        },
        {
          "help": "Reasoning effort level",
          "id": "reasoning_effort",
          "long": "reasoning-effort",
          "required": false,
          "short": "r"
        },
        {
          "help": "Session ID to continue (requires a prompt)",
          "id": "session_id",
          "long": "session-id",
          "required": false,
          "short": "s"
        },
        {
          "help": "Enable specific tools (comma or space separated)",
          "id": "enabled_tools",
          "long": "enabled-tools",
          "required": false,
          "short": null
        },
        {
          "help": "Disable specific tools (comma or space separated)",
          "id": "disabled_tools",
          "long": "disabled-tools",
          "required": false,
          "short": null
        },
        {
          "help": "List available tools for the selected model and exit",
          "id": "list_tools",
          "long": "list-tools",
          "required": false,
          "short": null
        },
        {
          "help": "Working directory path",
          "id": "cwd",
          "long": "cwd",
          "required": false,
          "short": null
        },
        {
          "help": "Maximum user turns per session (server-owned tool rounds are not client turns)",
          "id": "max_turns",
          "long": "max-turns",
          "required": false,
          "short": null
        },
        {
          "help": "Timeout in seconds (0 for no timeout)",
          "id": "timeout",
          "long": "timeout",
          "required": false,
          "short": null
        },
        {
          "help": "Image files to attach to the prompt",
          "id": "images",
          "long": "image",
          "required": false,
          "short": "i"
        },
        {
          "help": "Verbose output (show tool calls, reasoning)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Client instructions sent as additional user context, not a service system override",
          "id": "system_prompt",
          "long": "system",
          "required": false,
          "short": null
        },
        {
          "help": "Maximum tokens for response generation. Limits the length of the AI's response",
          "id": "max_tokens",
          "long": "max-tokens",
          "required": false,
          "short": null
        },
        {
          "help": "Include the prompt in the output (echo mode). When enabled, the original prompt will be included at the beginning of the response",
          "id": "echo",
          "long": "echo",
          "required": false,
          "short": null
        },
        {
          "help": "User identifier for tracking and rate limiting. This ID is passed to the API for usage tracking purposes",
          "id": "user",
          "long": "user",
          "required": false,
          "short": null
        },
        {
          "help": "Suffix text for completion insertion mode. The model will generate text to insert between the prompt and this suffix",
          "id": "suffix",
          "long": "suffix",
          "required": false,
          "short": null
        },
        {
          "help": "Response format for structured output. Valid values: text, json, json_object",
          "id": "response_format",
          "long": "response-format",
          "required": false,
          "short": null
        },
        {
          "help": "URLs to fetch and include in the context. Content from these URLs will be fetched and added to the prompt",
          "id": "urls",
          "long": "url",
          "required": false,
          "short": null
        },
        {
          "help": "Read input from the system clipboard. The clipboard content will be appended to the prompt",
          "id": "clipboard",
          "long": "clipboard",
          "required": false,
          "short": null
        },
        {
          "help": "Include current git diff in the context. Useful for code review tasks",
          "id": "git_diff",
          "long": "git-diff",
          "required": false,
          "short": null
        },
        {
          "help": "Include only files matching these patterns. Supports glob patterns like \"*.py\" or \"src/**/*.rs\"",
          "id": "include_patterns",
          "long": "include",
          "required": false,
          "short": null
        },
        {
          "help": "Exclude files matching these patterns. Supports glob patterns like \"*.test.js\" or \"node_modules/**\"",
          "id": "exclude_patterns",
          "long": "exclude",
          "required": false,
          "short": null
        },
        {
          "help": "Frequency penalty (-2.0 to 2.0). Positive values penalize tokens based on their frequency in the text so far, decreasing the likelihood of repeating the same content verbatim",
          "id": "frequency_penalty",
          "long": "frequency-penalty",
          "required": false,
          "short": null
        },
        {
          "help": "Presence penalty (-2.0 to 2.0). Positive values penalize new tokens based on whether they appear in the text so far, increasing the likelihood of talking about new topics",
          "id": "presence_penalty",
          "long": "presence-penalty",
          "required": false,
          "short": null
        },
        {
          "help": "Stop sequences (can be specified multiple times). Generation will stop when any of these sequences is encountered",
          "id": "stop_sequences",
          "long": "stop",
          "required": false,
          "short": null
        },
        {
          "help": "Request log probabilities for output tokens. Returns the log probabilities of the most likely tokens (up to 5)",
          "id": "logprobs",
          "long": "logprobs",
          "required": false,
          "short": null
        },
        {
          "help": "Number of completions to generate. Returns multiple independent completions for the same prompt",
          "id": "num_completions",
          "long": "n",
          "required": false,
          "short": "n"
        },
        {
          "help": "Generate best_of completions and return the best one. Must be greater than n if n is specified",
          "id": "best_of",
          "long": "best-of",
          "required": false,
          "short": null
        },
        {
          "help": "JSON schema for structured output. Can be inline JSON (e.g., '{\"type\":\"object\",\"properties\":{...}}') or a path to a JSON schema file",
          "id": "output_schema",
          "long": "output-schema",
          "required": false,
          "short": null
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "exec",
      "subcommands": []
    },
    {
      "about": "Resume a previous interactive session",
      "arguments": [
        {
          "help": "Session ID to resume (or \"last\" for most recent)",
          "id": "session_id",
          "long": null,
          "required": false,
          "short": null
        },
        {
          "help": "Continue the most recent session without showing the picker",
          "id": "last",
          "long": "last",
          "required": false,
          "short": null
        },
        {
          "help": "Show interactive picker to select from recent sessions",
          "id": "pick",
          "long": "pick",
          "required": false,
          "short": null
        },
        {
          "help": "Show all sessions (disables cwd filtering)",
          "id": "all",
          "long": "all",
          "required": false,
          "short": null
        },
        {
          "help": "Do not persist session changes (incompatible with resume, will error)",
          "id": "no_session",
          "long": "no-session",
          "required": false,
          "short": null
        },
        {
          "help": "Configuration overrides in the form key=value",
          "id": "raw_overrides",
          "long": "config",
          "required": false,
          "short": "c"
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "resume",
      "subcommands": []
    },
    {
      "about": "List previous sessions",
      "arguments": [
        {
          "help": "Show all sessions including from other directories",
          "id": "all",
          "long": "all",
          "required": false,
          "short": null
        },
        {
          "help": "Show sessions from the last N days",
          "id": "days",
          "long": "days",
          "required": false,
          "short": null
        },
        {
          "help": "Show sessions since this date (YYYY-MM-DD)",
          "id": "since",
          "long": "since",
          "required": false,
          "short": null
        },
        {
          "help": "Show sessions until this date (YYYY-MM-DD)",
          "id": "until",
          "long": "until",
          "required": false,
          "short": null
        },
        {
          "help": "Show only favorite sessions",
          "id": "favorites",
          "long": "favorites",
          "required": false,
          "short": null
        },
        {
          "help": "Search sessions by title or ID",
          "id": "search",
          "long": "search",
          "required": false,
          "short": "s"
        },
        {
          "help": "Maximum number of sessions to show",
          "id": "limit",
          "long": "limit",
          "required": false,
          "short": "l"
        },
        {
          "help": "Output in JSON format",
          "id": "json",
          "long": "json",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "sessions",
      "subcommands": []
    },
    {
      "about": "Export a session to JSON format",
      "arguments": [
        {
          "help": "Session ID to export (interactive picker if not provided)",
          "id": "session_id",
          "long": null,
          "required": false,
          "short": null
        },
        {
          "help": "Output file path (stdout if not specified)",
          "id": "output",
          "long": "output",
          "required": false,
          "short": "o"
        },
        {
          "help": "Output format (json, yaml, csv)",
          "id": "format",
          "long": "format",
          "required": false,
          "short": "f"
        },
        {
          "help": "Pretty-print the output (for json/yaml)",
          "id": "pretty",
          "long": "pretty",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "export",
      "subcommands": []
    },
    {
      "about": "Import a session from JSON file or URL",
      "arguments": [
        {
          "help": "Path to the JSON file to import, URL to fetch, or \"-\" for stdin",
          "id": "source",
          "long": null,
          "required": true,
          "short": null
        },
        {
          "help": "Force import even if session already exists",
          "id": "force",
          "long": "force",
          "required": false,
          "short": "f"
        },
        {
          "help": "Resume the imported session after import",
          "id": "resume",
          "long": "resume",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "import",
      "subcommands": []
    },
    {
      "about": "Delete a session",
      "arguments": [
        {
          "help": "Session ID to delete (full UUID or 8-character prefix)",
          "id": "session_id",
          "long": null,
          "required": true,
          "short": null
        },
        {
          "help": "Skip confirmation prompt",
          "id": "yes",
          "long": "yes",
          "required": false,
          "short": "y"
        },
        {
          "help": "Force deletion even if session is locked",
          "id": "force",
          "long": "force",
          "required": false,
          "short": "f"
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "delete",
      "subcommands": []
    },
    {
      "about": "Authenticate with Cortex API",
      "arguments": [
        {
          "help": "Read the API key from stdin",
          "id": "with_api_key",
          "long": "with-api-key",
          "required": false,
          "short": null
        },
        {
          "help": "Provide API token directly (for CI/CD automation)",
          "id": "token",
          "long": "token",
          "required": false,
          "short": null
        },
        {
          "help": "Use device code authentication flow",
          "id": "use_device_code",
          "long": "device-auth",
          "required": false,
          "short": null
        },
        {
          "help": "Use enterprise SSO authentication",
          "id": "use_sso",
          "long": "sso",
          "required": false,
          "short": null
        },
        {
          "help": "Override the OAuth issuer base URL (advanced)",
          "id": "issuer_base_url",
          "long": "experimental_issuer",
          "required": false,
          "short": null
        },
        {
          "help": "Override the OAuth client ID (advanced)",
          "id": "client_id",
          "long": "experimental_client-id",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "login",
      "subcommands": [
        {
          "about": "Show login status",
          "arguments": [
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "status",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "Show login status",
              "arguments": [],
              "name": "status",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "Remove stored authentication credentials",
      "arguments": [
        {
          "help": "Skip confirmation prompt and log out immediately",
          "id": "yes",
          "long": "yes",
          "required": false,
          "short": "y"
        },
        {
          "help": "Log out from all logged in accounts",
          "id": "all",
          "long": "all",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "logout",
      "subcommands": []
    },
    {
      "about": "Show currently authenticated user",
      "arguments": [
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "whoami",
      "subcommands": []
    },
    {
      "about": "Manage agents (list, create, show)",
      "arguments": [
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "agent",
      "subcommands": [
        {
          "about": "List all available agents",
          "arguments": [
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Show only primary agents",
              "id": "primary",
              "long": "primary",
              "required": false,
              "short": null
            },
            {
              "help": "Show only subagents",
              "id": "subagents",
              "long": "subagents",
              "required": false,
              "short": null
            },
            {
              "help": "Show all agents including hidden ones",
              "id": "all",
              "long": "all",
              "required": false,
              "short": null
            },
            {
              "help": "List agents from remote registry",
              "id": "remote",
              "long": "remote",
              "required": false,
              "short": null
            },
            {
              "help": "Filter agents by pattern (glob-style matching). Example: --filter \"python*\" or --filter \"*test*\"",
              "id": "filter",
              "long": "filter",
              "required": false,
              "short": null
            },
            {
              "help": "Output only agent names (one per line) for shell completion",
              "id": "names_only",
              "long": "names-only",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "list",
          "subcommands": []
        },
        {
          "about": "Show details for a specific agent",
          "arguments": [
            {
              "help": "Name of the agent to display",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Show how agent would work with a specific model override",
              "id": "model",
              "long": "model",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "show",
          "subcommands": []
        },
        {
          "about": "Create a new agent interactively",
          "arguments": [
            {
              "help": "Agent name (if not provided, interactive mode will prompt)",
              "id": "name",
              "long": "name",
              "required": false,
              "short": "n"
            },
            {
              "help": "Agent description",
              "id": "description",
              "long": "description",
              "required": false,
              "short": "d"
            },
            {
              "help": "Agent mode: primary, subagent, or all",
              "id": "mode",
              "long": "mode",
              "required": false,
              "short": "m"
            },
            {
              "help": "Skip interactive prompts and use defaults",
              "id": "non_interactive",
              "long": "non-interactive",
              "required": false,
              "short": null
            },
            {
              "help": "Generate agent using AI from a natural language description. Example: --generate \"A Rust expert that helps with memory safety and performance\" Note: This feature requires authentication. Run 'cortex login' first or set CORTEX_AUTH_TOKEN",
              "id": "generate",
              "long": "generate",
              "required": false,
              "short": "g"
            },
            {
              "help": "Model to use for AI generation (default: gpt-4o)",
              "id": "model",
              "long": "model",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "create",
          "subcommands": []
        },
        {
          "about": "Edit an existing agent in your default editor",
          "arguments": [
            {
              "help": "Name of the agent to edit",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Editor to use (defaults to $EDITOR or $VISUAL)",
              "id": "editor",
              "long": "editor",
              "required": false,
              "short": "e"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "edit",
          "subcommands": []
        },
        {
          "about": "Remove a user-defined agent",
          "arguments": [
            {
              "help": "Name of the agent to remove",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Force removal without confirmation",
              "id": "force",
              "long": "force",
              "required": false,
              "short": "f"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "remove",
          "subcommands": []
        },
        {
          "about": "Install an agent from the registry",
          "arguments": [
            {
              "help": "Name or URL of the agent to install from registry",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Force overwrite if agent already exists",
              "id": "force",
              "long": "force",
              "required": false,
              "short": "f"
            },
            {
              "help": "Registry URL to install from (defaults to official registry)",
              "id": "registry",
              "long": "registry",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "install",
          "subcommands": []
        },
        {
          "about": "Copy/clone an existing agent with a new name",
          "arguments": [
            {
              "help": "Name of the agent to copy",
              "id": "source",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Name for the new agent copy",
              "id": "destination",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Force overwrite if destination agent already exists",
              "id": "force",
              "long": "force",
              "required": false,
              "short": "f"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "copy",
          "subcommands": []
        },
        {
          "about": "Export an agent definition to stdout or a file",
          "arguments": [
            {
              "help": "Name of the agent to export",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Output file path (defaults to stdout)",
              "id": "output",
              "long": "output",
              "required": false,
              "short": "o"
            },
            {
              "help": "Export as JSON instead of markdown",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "export",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "List all available agents",
              "arguments": [],
              "name": "list",
              "subcommands": []
            },
            {
              "about": "Show details for a specific agent",
              "arguments": [],
              "name": "show",
              "subcommands": []
            },
            {
              "about": "Create a new agent interactively",
              "arguments": [],
              "name": "create",
              "subcommands": []
            },
            {
              "about": "Edit an existing agent in your default editor",
              "arguments": [],
              "name": "edit",
              "subcommands": []
            },
            {
              "about": "Remove a user-defined agent",
              "arguments": [],
              "name": "remove",
              "subcommands": []
            },
            {
              "about": "Install an agent from the registry",
              "arguments": [],
              "name": "install",
              "subcommands": []
            },
            {
              "about": "Copy/clone an existing agent with a new name",
              "arguments": [],
              "name": "copy",
              "subcommands": []
            },
            {
              "about": "Export an agent definition to stdout or a file",
              "arguments": [],
              "name": "export",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "Manage MCP (Model Context Protocol) servers",
      "arguments": [
        {
          "help": "Configuration overrides in the form key=value",
          "id": "raw_overrides",
          "long": "config",
          "required": false,
          "short": "c"
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "mcp",
      "subcommands": [
        {
          "about": "List configured MCP servers",
          "arguments": [
            {
              "help": "Output the configured servers as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Show all servers including disabled ones",
              "id": "all",
              "long": "all",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "list",
          "subcommands": []
        },
        {
          "about": "Show details for a configured MCP server",
          "arguments": [
            {
              "help": "Name of the MCP server to display",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Output the server configuration as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "get",
          "subcommands": []
        },
        {
          "about": "Add a global MCP server entry",
          "arguments": [
            {
              "help": "Name for the MCP server configuration",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Overwrite existing server configuration if it exists",
              "id": "force",
              "long": "force",
              "required": false,
              "short": "f"
            },
            {
              "help": "Allow localhost and private network URLs (for local development). By default, URLs containing localhost, 127.0.0.1, or private network addresses are blocked for security. Use this flag to enable local development servers",
              "id": "allow_local",
              "long": "allow-local",
              "required": false,
              "short": null
            },
            {
              "help": "Command to launch the MCP server",
              "id": "command",
              "long": null,
              "required": false,
              "short": null
            },
            {
              "help": "Environment variables to set when launching the server",
              "id": "env",
              "long": "env",
              "required": false,
              "short": null
            },
            {
              "help": "URL for a streamable HTTP MCP server",
              "id": "url",
              "long": "url",
              "required": true,
              "short": null
            },
            {
              "help": "Name of the environment variable containing a bearer token (not the token itself). The CLI will read the token value from this env var at runtime. Example: --bearer-token-env-var MY_API_TOKEN (where MY_API_TOKEN env var contains the token)",
              "id": "bearer_token_env_var",
              "long": "bearer-token-env-var",
              "required": false,
              "short": null
            },
            {
              "help": "Extra HTTP headers (`KEY=VALUE`). Repeatable. Do not put secrets in the value — prefer `env:VAR` style refs or `--bearer-token-env-var`",
              "id": "headers",
              "long": "header",
              "required": false,
              "short": null
            },
            {
              "help": "URL for an SSE (Server-Sent Events) MCP server. Use this for MCP servers that communicate via SSE transport",
              "id": "sse_url",
              "long": "sse",
              "required": false,
              "short": null
            },
            {
              "help": "Optional environment variable to read for a bearer token",
              "id": "sse_bearer_token_env_var",
              "long": "sse-bearer-token-env-var",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "add",
          "subcommands": []
        },
        {
          "about": "Remove a global MCP server entry",
          "arguments": [
            {
              "help": "Name of the MCP server configuration to remove",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Skip confirmation prompt. Aliases: --force, -f (for compatibility)",
              "id": "yes",
              "long": "yes",
              "required": false,
              "short": "y"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "remove",
          "subcommands": []
        },
        {
          "about": "Enable a disabled MCP server",
          "arguments": [
            {
              "help": "Name of the MCP server to enable",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "enable",
          "subcommands": []
        },
        {
          "about": "Disable an MCP server without removing it",
          "arguments": [
            {
              "help": "Name of the MCP server to disable",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "disable",
          "subcommands": []
        },
        {
          "about": "Rename an MCP server",
          "arguments": [
            {
              "help": "Current name of the MCP server",
              "id": "old_name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "New name for the MCP server",
              "id": "new_name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "rename",
          "subcommands": []
        },
        {
          "about": "Authenticate with an OAuth-enabled MCP server",
          "arguments": [
            {
              "help": "Name of the MCP server to authenticate with (if no subcommand)",
              "id": "name",
              "long": null,
              "required": false,
              "short": null
            },
            {
              "help": "Client ID for OAuth (if not using dynamic registration)",
              "id": "client_id",
              "long": "client-id",
              "required": false,
              "short": null
            },
            {
              "help": "Client secret for OAuth (if required)",
              "id": "client_secret",
              "long": "client-secret",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "auth",
          "subcommands": [
            {
              "about": "List OAuth status for all servers",
              "arguments": [
                {
                  "help": "Output as JSON",
                  "id": "json",
                  "long": "json",
                  "required": false,
                  "short": null
                },
                {
                  "help": "Enable verbose output (same as --log-level debug)",
                  "id": "verbose",
                  "long": "verbose",
                  "required": false,
                  "short": "v"
                },
                {
                  "help": "Enable trace-level logging for debugging",
                  "id": "trace",
                  "long": "trace",
                  "required": false,
                  "short": null
                },
                {
                  "help": "Control color output: auto (default), always, or never",
                  "id": "color",
                  "long": "color",
                  "required": false,
                  "short": null
                },
                {
                  "help": "Print help (see more with '--help')",
                  "id": "help",
                  "long": "help",
                  "required": false,
                  "short": "h"
                }
              ],
              "name": "list",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": [
                {
                  "about": "List OAuth status for all servers",
                  "arguments": [],
                  "name": "list",
                  "subcommands": []
                },
                {
                  "about": "Print this message or the help of the given subcommand(s)",
                  "arguments": [],
                  "name": "help",
                  "subcommands": []
                }
              ]
            }
          ]
        },
        {
          "about": "Remove OAuth credentials for an MCP server",
          "arguments": [
            {
              "help": "Name of the MCP server to remove credentials for",
              "id": "name",
              "long": null,
              "required": false,
              "short": null
            },
            {
              "help": "Remove OAuth credentials for all servers",
              "id": "all",
              "long": "all",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "logout",
          "subcommands": []
        },
        {
          "about": "Debug and test an MCP server connection",
          "arguments": [
            {
              "help": "Name of the MCP server to debug",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Test OAuth authentication if configured",
              "id": "test_auth",
              "long": "test-auth",
              "required": false,
              "short": null
            },
            {
              "help": "Timeout in seconds for connection test",
              "id": "timeout",
              "long": "timeout",
              "required": false,
              "short": null
            },
            {
              "help": "Force fresh health check, bypassing any cache. By default, health checks may be cached for performance. Use this flag to ensure you get the current status after making configuration changes",
              "id": "no_cache",
              "long": "no-cache",
              "required": false,
              "short": null
            },
            {
              "help": "Show cache information when displaying cached results. Displays the age of cached health status if available",
              "id": "show_cache_info",
              "long": "show-cache-info",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "debug",
          "subcommands": []
        },
        {
          "about": "List tools exposed by a configured MCP server",
          "arguments": [
            {
              "help": "Name of the MCP server whose tools to list",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Timeout in seconds for the connection",
              "id": "timeout",
              "long": "timeout",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "tools",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "List configured MCP servers",
              "arguments": [],
              "name": "list",
              "subcommands": []
            },
            {
              "about": "Show details for a configured MCP server",
              "arguments": [],
              "name": "get",
              "subcommands": []
            },
            {
              "about": "Add a global MCP server entry",
              "arguments": [],
              "name": "add",
              "subcommands": []
            },
            {
              "about": "Remove a global MCP server entry",
              "arguments": [],
              "name": "remove",
              "subcommands": []
            },
            {
              "about": "Enable a disabled MCP server",
              "arguments": [],
              "name": "enable",
              "subcommands": []
            },
            {
              "about": "Disable an MCP server without removing it",
              "arguments": [],
              "name": "disable",
              "subcommands": []
            },
            {
              "about": "Rename an MCP server",
              "arguments": [],
              "name": "rename",
              "subcommands": []
            },
            {
              "about": "Authenticate with an OAuth-enabled MCP server",
              "arguments": [],
              "name": "auth",
              "subcommands": [
                {
                  "about": "List OAuth status for all servers",
                  "arguments": [],
                  "name": "list",
                  "subcommands": []
                }
              ]
            },
            {
              "about": "Remove OAuth credentials for an MCP server",
              "arguments": [],
              "name": "logout",
              "subcommands": []
            },
            {
              "about": "Debug and test an MCP server connection",
              "arguments": [],
              "name": "debug",
              "subcommands": []
            },
            {
              "about": "List tools exposed by a configured MCP server",
              "arguments": [],
              "name": "tools",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "Run the MCP server (stdio transport)",
      "arguments": [
        {
          "help": "Run the Cortex verification MCP over stdio JSON-RPC (`cortex-verify/1`)",
          "id": "verify",
          "long": "verify",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "mcp-server",
      "subcommands": []
    },
    {
      "about": "Start ACP server for IDE integration (e.g., Zed)",
      "arguments": [
        {
          "help": "Working directory for the session",
          "id": "cwd",
          "long": "cwd",
          "required": false,
          "short": "C"
        },
        {
          "help": "Reserved network port. Nonzero values are unsupported",
          "id": "port",
          "long": "port",
          "required": false,
          "short": "p"
        },
        {
          "help": "Host address to bind to",
          "id": "host",
          "long": "host",
          "required": false,
          "short": null
        },
        {
          "help": "Use stdio transport (JSON-RPC over stdin/stdout)",
          "id": "stdio",
          "long": "stdio",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose/debug output",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Model to use",
          "id": "model",
          "long": "model",
          "required": false,
          "short": "m"
        },
        {
          "help": "Agent to use",
          "id": "agent",
          "long": "agent",
          "required": false,
          "short": null
        },
        {
          "help": "Tools to allow (whitelist). Can be specified multiple times. Only these tools will be available to the agent",
          "id": "allow_tools",
          "long": "allow-tool",
          "required": false,
          "short": null
        },
        {
          "help": "Tools to deny (blacklist). Can be specified multiple times. These tools will be blocked from use",
          "id": "deny_tools",
          "long": "deny-tool",
          "required": false,
          "short": null
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "acp",
      "subcommands": []
    },
    {
      "about": "Show or edit configuration",
      "arguments": [
        {
          "help": "Show configuration in JSON format",
          "id": "json",
          "long": "json",
          "required": false,
          "short": null
        },
        {
          "help": "Edit configuration interactively",
          "id": "edit",
          "long": "edit",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "config",
      "subcommands": [
        {
          "about": "Get a configuration value",
          "arguments": [
            {
              "help": "Configuration key to get (e.g., model, provider)",
              "id": "key",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "get",
          "subcommands": []
        },
        {
          "about": "Set a configuration value",
          "arguments": [
            {
              "help": "Configuration key (e.g., model, provider)",
              "id": "key",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Value to set",
              "id": "value",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "set",
          "subcommands": []
        },
        {
          "about": "Unset (remove) a configuration value",
          "arguments": [
            {
              "help": "Configuration key to remove",
              "id": "key",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "unset",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "Get a configuration value",
              "arguments": [],
              "name": "get",
              "subcommands": []
            },
            {
              "about": "Set a configuration value",
              "arguments": [],
              "name": "set",
              "subcommands": []
            },
            {
              "about": "Unset (remove) a configuration value",
              "arguments": [],
              "name": "unset",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "List available models",
      "arguments": [
        {
          "help": "Filter by provider name",
          "id": "provider",
          "long": null,
          "required": false,
          "short": null
        },
        {
          "help": "Output as JSON",
          "id": "json",
          "long": "json",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "models",
      "subcommands": [
        {
          "about": "List all available models",
          "arguments": [
            {
              "help": "Filter by provider name",
              "id": "provider",
              "long": null,
              "required": false,
              "short": null
            },
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Limit number of results (for pagination)",
              "id": "limit",
              "long": "limit",
              "required": false,
              "short": null
            },
            {
              "help": "Offset for pagination (skip first N models)",
              "id": "offset",
              "long": "offset",
              "required": false,
              "short": null
            },
            {
              "help": "Sort order for models (id, name, provider) (Issue #1993)",
              "id": "sort",
              "long": "sort",
              "required": false,
              "short": null
            },
            {
              "help": "Show full model IDs without truncation (Issue #1991)",
              "id": "full",
              "long": "full",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "list",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "List all available models",
              "arguments": [],
              "name": "list",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "Inspect feature flags",
      "arguments": [
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "features",
      "subcommands": [
        {
          "about": "List known features with their stage and effective state",
          "arguments": [
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "list",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "List known features with their stage and effective state",
              "arguments": [],
              "name": "list",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "Initialize AGENTS.md in the current directory",
      "arguments": [
        {
          "help": "Force overwrite if AGENTS.md already exists",
          "id": "force",
          "long": "force",
          "required": false,
          "short": "f"
        },
        {
          "help": "Accept defaults without prompting (non-interactive mode)",
          "id": "yes",
          "long": "yes",
          "required": false,
          "short": "y"
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "init",
      "subcommands": []
    },
    {
      "about": "GitHub integration (actions, workflows)",
      "arguments": [
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "github",
      "subcommands": [
        {
          "about": "Install GitHub Actions workflow for Cortex CI/CD automation",
          "arguments": [
            {
              "help": "Path to the repository root (defaults to current directory)",
              "id": "path",
              "long": "path",
              "required": false,
              "short": "p"
            },
            {
              "help": "Force overwrite existing workflow file",
              "id": "force",
              "long": "force",
              "required": false,
              "short": "f"
            },
            {
              "help": "Include read-only PR analysis. Publication requires --publish",
              "id": "pr_review",
              "long": "pr-review",
              "required": false,
              "short": null
            },
            {
              "help": "Include issue automation",
              "id": "issue_automation",
              "long": "issue-automation",
              "required": false,
              "short": null
            },
            {
              "help": "Custom workflow name",
              "id": "workflow_name",
              "long": "workflow-name",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "install",
          "subcommands": []
        },
        {
          "about": "Run GitHub agent in Actions context",
          "arguments": [
            {
              "help": "GitHub event type (issue_comment, pull_request, issues, etc.)",
              "id": "event",
              "long": "event",
              "required": true,
              "short": "e"
            },
            {
              "help": "GitHub token for API access",
              "id": "token",
              "long": "token",
              "required": false,
              "short": "t"
            },
            {
              "help": "Path to the event payload JSON file",
              "id": "event_path",
              "long": "event-path",
              "required": false,
              "short": null
            },
            {
              "help": "GitHub repository (owner/repo format)",
              "id": "repository",
              "long": "repository",
              "required": false,
              "short": null
            },
            {
              "help": "GitHub run ID",
              "id": "run_id",
              "long": "run-id",
              "required": false,
              "short": null
            },
            {
              "help": "Dry run mode - don't execute, just show what would happen",
              "id": "dry_run",
              "long": "dry-run",
              "required": false,
              "short": null
            },
            {
              "help": "Explicitly approve publishing the completed response as a GitHub comment",
              "id": "publish",
              "long": "publish",
              "required": false,
              "short": null
            },
            {
              "help": "Save the completed response locally (created exclusively, never overwritten)",
              "id": "output",
              "long": "output",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "run",
          "subcommands": []
        },
        {
          "about": "Check GitHub Actions installation status",
          "arguments": [
            {
              "help": "Path to the repository root (defaults to current directory)",
              "id": "path",
              "long": "path",
              "required": false,
              "short": "p"
            },
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "status",
          "subcommands": []
        },
        {
          "about": "Uninstall/remove the Cortex GitHub workflow",
          "arguments": [
            {
              "help": "Path to the repository root (defaults to current directory)",
              "id": "path",
              "long": "path",
              "required": false,
              "short": "p"
            },
            {
              "help": "Workflow name to remove (defaults to \"cortex\")",
              "id": "workflow_name",
              "long": "workflow-name",
              "required": false,
              "short": null
            },
            {
              "help": "Force removal without confirmation",
              "id": "force",
              "long": "force",
              "required": false,
              "short": "f"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "uninstall",
          "subcommands": []
        },
        {
          "about": "Update the Cortex GitHub workflow to the latest version",
          "arguments": [
            {
              "help": "Path to the repository root (defaults to current directory)",
              "id": "path",
              "long": "path",
              "required": false,
              "short": "p"
            },
            {
              "help": "Workflow name to update (defaults to \"cortex\")",
              "id": "workflow_name",
              "long": "workflow-name",
              "required": false,
              "short": null
            },
            {
              "help": "Include PR review automation",
              "id": "pr_review",
              "long": "pr-review",
              "required": false,
              "short": null
            },
            {
              "help": "Include issue automation",
              "id": "issue_automation",
              "long": "issue-automation",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "update",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "Install GitHub Actions workflow for Cortex CI/CD automation",
              "arguments": [],
              "name": "install",
              "subcommands": []
            },
            {
              "about": "Run GitHub agent in Actions context",
              "arguments": [],
              "name": "run",
              "subcommands": []
            },
            {
              "about": "Check GitHub Actions installation status",
              "arguments": [],
              "name": "status",
              "subcommands": []
            },
            {
              "about": "Uninstall/remove the Cortex GitHub workflow",
              "arguments": [],
              "name": "uninstall",
              "subcommands": []
            },
            {
              "about": "Update the Cortex GitHub workflow to the latest version",
              "arguments": [],
              "name": "update",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "Checkout a pull request",
      "arguments": [
        {
          "help": "PR number to checkout",
          "id": "number",
          "long": null,
          "required": true,
          "short": null
        },
        {
          "help": "Path to the repository root (defaults to current directory)",
          "id": "path",
          "long": "path",
          "required": false,
          "short": "p"
        },
        {
          "help": "Custom local branch name for the PR checkout. If not specified, defaults to \"pr-{number}\"",
          "id": "branch",
          "long": "branch",
          "required": false,
          "short": "b"
        },
        {
          "help": "Force checkout even if there are uncommitted changes. WARNING: This may result in data loss! Uncommitted changes in your working directory may be overwritten. Consider using 'git stash' first to save your work",
          "id": "force",
          "long": "force",
          "required": false,
          "short": "F"
        },
        {
          "help": "Show PR details without checking out",
          "id": "info",
          "long": "info",
          "required": false,
          "short": null
        },
        {
          "help": "Show PR diff without checking out",
          "id": "diff",
          "long": "diff",
          "required": false,
          "short": null
        },
        {
          "help": "Show PR comments",
          "id": "comments",
          "long": "comments",
          "required": false,
          "short": null
        },
        {
          "help": "Apply AI-suggested changes to working tree",
          "id": "apply",
          "long": "apply",
          "required": false,
          "short": null
        },
        {
          "help": "GitHub token for API access (for private repos)",
          "id": "token",
          "long": "token",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "pr",
      "subcommands": []
    },
    {
      "about": "Scrape web content to markdown/text/html",
      "arguments": [
        {
          "help": "URL to scrape",
          "id": "url",
          "long": null,
          "required": true,
          "short": null
        },
        {
          "help": "Output file path (stdout if not specified)",
          "id": "output",
          "long": "output",
          "required": false,
          "short": "o"
        },
        {
          "help": "Output format (markdown, text, html)",
          "id": "format",
          "long": "format",
          "required": false,
          "short": "f"
        },
        {
          "help": "HTTP method to use for the request. Use HEAD to check headers without downloading content. Supported values: GET (default), HEAD, POST",
          "id": "method",
          "long": "method",
          "required": false,
          "short": null
        },
        {
          "help": "Request timeout in seconds (0 means no timeout)",
          "id": "timeout",
          "long": "timeout",
          "required": false,
          "short": "t"
        },
        {
          "help": "Number of retries for 5xx server errors (default: 3). Set to 0 to disable retries",
          "id": "retries",
          "long": "retries",
          "required": false,
          "short": null
        },
        {
          "help": "Custom User-Agent string to identify the request. Common examples: Mozilla/5.0 (compatible; Googlebot/2.1)   - Googlebot Mozilla/5.0 (Windows NT 10.0; Win64)      - Windows browser curl/7.68.0                               - curl client PostmanRuntime/7.29.0                     - Postman Some sites block requests from unknown user agents",
          "id": "user_agent",
          "long": "user-agent",
          "required": false,
          "short": null
        },
        {
          "help": "Custom headers (format: \"Header-Name: value\")",
          "id": "headers",
          "long": "header",
          "required": false,
          "short": "H"
        },
        {
          "help": "Cookie to send with the request (format: \"name=value\"). Can be specified multiple times for multiple cookies. Example: --cookie \"session=abc123\" --cookie \"user=john\"",
          "id": "cookies",
          "long": "cookie",
          "required": false,
          "short": null
        },
        {
          "help": "Disable following HTTP redirects. By default, up to 10 redirects are followed",
          "id": "no_follow_redirects",
          "long": "no-follow-redirects",
          "required": false,
          "short": null
        },
        {
          "help": "Strip images from output",
          "id": "no_images",
          "long": "no-images",
          "required": false,
          "short": null
        },
        {
          "help": "Strip links from output (keep text only)",
          "id": "no_links",
          "long": "no-links",
          "required": false,
          "short": null
        },
        {
          "help": "CSS selectors to extract specific elements from the page. Can be specified multiple times to combine selectors. Examples: article           - Select all <article> elements .content          - Select elements with class \"content\" #main             - Select element with id \"main\" div.post > p      - Select <p> children of div.post table tbody tr    - Select table rows in tbody h1, h2, h3        - Select multiple heading levels [data-id=\"123\"]   - Select by attribute Multiple selectors: --selector \"h1\" --selector \"p\"",
          "id": "selector",
          "long": "selector",
          "required": false,
          "short": null
        },
        {
          "help": "XPath expression to extract specific elements from the page. Examples: //article                      - Select all <article> elements //div[@class='content']        - Select div with class \"content\" //*[@id='main']                - Select element with id \"main\" //div[@class='post']/p         - Select <p> children of div.post //table/tbody/tr               - Select table rows in tbody //h1 | //h2 | //h3             - Select multiple heading levels Note: XPath support requires external parsing and may be slower than CSS",
          "id": "xpath",
          "long": "xpath",
          "required": false,
          "short": null
        },
        {
          "help": "Show verbose output (includes fetching info)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Pretty-print JSON and XML responses with proper formatting",
          "id": "pretty",
          "long": "pretty",
          "required": false,
          "short": null
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "scrape",
      "subcommands": []
    },
    {
      "about": "Show usage statistics",
      "arguments": [
        {
          "help": "Number of days to include (default: 30, range: 1-3650)",
          "id": "days",
          "long": "days",
          "required": false,
          "short": "d"
        },
        {
          "help": "Filter by specific provider",
          "id": "provider",
          "long": "provider",
          "required": false,
          "short": "p"
        },
        {
          "help": "Filter by specific model",
          "id": "model",
          "long": "model",
          "required": false,
          "short": "m"
        },
        {
          "help": "Output as JSON",
          "id": "json",
          "long": "json",
          "required": false,
          "short": null
        },
        {
          "help": "Show detailed breakdown",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "stats",
      "subcommands": []
    },
    {
      "about": "Generate shell completion scripts",
      "arguments": [
        {
          "help": "Shell to generate completions for",
          "id": "shell",
          "long": null,
          "required": false,
          "short": null
        },
        {
          "help": "Install completions to your shell configuration file",
          "id": "install",
          "long": "install",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "completion",
      "subcommands": []
    },
    {
      "about": "Check for and install updates",
      "arguments": [
        {
          "help": "Target version to upgrade to (e.g., \"1.2.0\") If not specified, upgrades to the latest version",
          "id": "version",
          "long": null,
          "required": false,
          "short": null
        },
        {
          "help": "Only check for updates without installing",
          "id": "check",
          "long": "check",
          "required": false,
          "short": "c"
        },
        {
          "help": "Show changelog for the target version",
          "id": "changelog",
          "long": "changelog",
          "required": false,
          "short": null
        },
        {
          "help": "Force upgrade even if already on the target version",
          "id": "force",
          "long": "force",
          "required": false,
          "short": "f"
        },
        {
          "help": "Skip confirmation prompts",
          "id": "yes",
          "long": "yes",
          "required": false,
          "short": "y"
        },
        {
          "help": "Release channel to use (stable, beta, nightly)",
          "id": "channel",
          "long": "channel",
          "required": false,
          "short": null
        },
        {
          "help": "Include prerelease versions (shorthand for --channel beta). When specified, allows installing beta/prerelease versions",
          "id": "pre",
          "long": "pre",
          "required": false,
          "short": null
        },
        {
          "help": "Use custom software distribution URL",
          "id": "url",
          "long": "url",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "upgrade",
      "subcommands": []
    },
    {
      "about": "Uninstall Cortex CLI",
      "arguments": [
        {
          "help": "Keep configuration files (config.toml, etc.)",
          "id": "keep_config",
          "long": "keep-config",
          "required": false,
          "short": "c"
        },
        {
          "help": "Keep session data and history",
          "id": "keep_data",
          "long": "keep-data",
          "required": false,
          "short": "d"
        },
        {
          "help": "Show what would be deleted without actually deleting",
          "id": "dry_run",
          "long": "dry-run",
          "required": false,
          "short": null
        },
        {
          "help": "Skip confirmation prompt",
          "id": "force",
          "long": "force",
          "required": false,
          "short": "f"
        },
        {
          "help": "Auto-confirm (alias for --force)",
          "id": "yes",
          "long": "yes",
          "required": false,
          "short": "y"
        },
        {
          "help": "Create backup before uninstalling",
          "id": "backup",
          "long": "backup",
          "required": false,
          "short": null
        },
        {
          "help": "Complete removal: delete everything including config and data. This is equivalent to not using --keep-config or --keep-data",
          "id": "purge",
          "long": "purge",
          "required": false,
          "short": "p"
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "uninstall",
      "subcommands": []
    },
    {
      "about": "Data compaction and cleanup (logs, sessions, history)",
      "arguments": [
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "compact",
      "subcommands": [
        {
          "about": "Run a compaction cycle (logs + sessions)",
          "arguments": [
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Dry run - show what would be done without actually doing it",
              "id": "dry_run",
              "long": "dry-run",
              "required": false,
              "short": null
            },
            {
              "help": "Force compaction even if lock is held (use with caution)",
              "id": "force",
              "long": "force",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "run",
          "subcommands": []
        },
        {
          "about": "Prune old log files",
          "arguments": [
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Dry run - show what would be deleted without actually deleting",
              "id": "dry_run",
              "long": "dry-run",
              "required": false,
              "short": null
            },
            {
              "help": "Keep logs from last N days (default: 7)",
              "id": "keep_days",
              "long": "keep-days",
              "required": false,
              "short": null
            },
            {
              "help": "Maximum log file size in MB for rotation (default: 10)",
              "id": "max_size_mb",
              "long": "max-size-mb",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "logs",
          "subcommands": []
        },
        {
          "about": "Vacuum session database (clean orphaned files)",
          "arguments": [
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Dry run - show what would be cleaned without actually cleaning",
              "id": "dry_run",
              "long": "dry-run",
              "required": false,
              "short": null
            },
            {
              "help": "Delete sessions older than N days (0 = keep all)",
              "id": "session_days",
              "long": "session-days",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "vacuum",
          "subcommands": []
        },
        {
          "about": "Show compaction status and statistics",
          "arguments": [
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "status",
          "subcommands": []
        },
        {
          "about": "Configure auto-compaction settings",
          "arguments": [
            {
              "help": "Enable auto-compaction",
              "id": "enable",
              "long": "enable",
              "required": false,
              "short": null
            },
            {
              "help": "Disable auto-compaction",
              "id": "disable",
              "long": "disable",
              "required": false,
              "short": null
            },
            {
              "help": "Set compaction interval in hours",
              "id": "interval_hours",
              "long": "interval-hours",
              "required": false,
              "short": null
            },
            {
              "help": "Set log retention period in days",
              "id": "log_retention_days",
              "long": "log-retention-days",
              "required": false,
              "short": null
            },
            {
              "help": "Output current config as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "config",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "Run a compaction cycle (logs + sessions)",
              "arguments": [],
              "name": "run",
              "subcommands": []
            },
            {
              "about": "Prune old log files",
              "arguments": [],
              "name": "logs",
              "subcommands": []
            },
            {
              "about": "Vacuum session database (clean orphaned files)",
              "arguments": [],
              "name": "vacuum",
              "subcommands": []
            },
            {
              "about": "Show compaction status and statistics",
              "arguments": [],
              "name": "status",
              "subcommands": []
            },
            {
              "about": "Configure auto-compaction settings",
              "arguments": [],
              "name": "config",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "Manage cache",
      "arguments": [
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "cache",
      "subcommands": [
        {
          "about": "Show cache information and statistics",
          "arguments": [
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "show",
          "subcommands": []
        },
        {
          "about": "Clear all or part of the cache",
          "arguments": [
            {
              "help": "Clear only model cache",
              "id": "models",
              "long": "models",
              "required": false,
              "short": null
            },
            {
              "help": "Clear only response cache",
              "id": "responses",
              "long": "responses",
              "required": false,
              "short": null
            },
            {
              "help": "Clear only update check cache",
              "id": "updates",
              "long": "updates",
              "required": false,
              "short": null
            },
            {
              "help": "Skip confirmation prompt",
              "id": "yes",
              "long": "yes",
              "required": false,
              "short": "y"
            },
            {
              "help": "Dry run - show what would be deleted without actually deleting",
              "id": "dry_run",
              "long": "dry-run",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "clear",
          "subcommands": []
        },
        {
          "about": "Show cache size",
          "arguments": [
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "size",
          "subcommands": []
        },
        {
          "about": "List cached items",
          "arguments": [
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Maximum number of items to show",
              "id": "limit",
              "long": "limit",
              "required": false,
              "short": "n"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "list",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "Show cache information and statistics",
              "arguments": [],
              "name": "show",
              "subcommands": []
            },
            {
              "about": "Clear all or part of the cache",
              "arguments": [],
              "name": "clear",
              "subcommands": []
            },
            {
              "about": "Show cache size",
              "arguments": [],
              "name": "size",
              "subcommands": []
            },
            {
              "about": "List cached items",
              "arguments": [],
              "name": "list",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "View application logs",
      "arguments": [
        {
          "help": "Number of lines to show (default: 100)",
          "id": "lines",
          "long": "lines",
          "required": false,
          "short": "n"
        },
        {
          "help": "Follow logs in real-time (like tail -f)",
          "id": "follow",
          "long": "follow",
          "required": false,
          "short": "f"
        },
        {
          "help": "Filter by log level (error, warn, info, debug, trace)",
          "id": "level",
          "long": "level",
          "required": false,
          "short": "l"
        },
        {
          "help": "Show logs from a specific session",
          "id": "session",
          "long": "session",
          "required": false,
          "short": "s"
        },
        {
          "help": "Output as JSON",
          "id": "json",
          "long": "json",
          "required": false,
          "short": null
        },
        {
          "help": "Show log file paths instead of content",
          "id": "paths",
          "long": "paths",
          "required": false,
          "short": null
        },
        {
          "help": "Clear old log files",
          "id": "clear",
          "long": "clear",
          "required": false,
          "short": null
        },
        {
          "help": "Keep logs from last N days when clearing (default: 7)",
          "id": "keep_days",
          "long": "keep-days",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "logs",
      "subcommands": []
    },
    {
      "about": "Submit feedback and bug reports",
      "arguments": [
        {
          "help": "Feedback message (if no subcommand)",
          "id": "message",
          "long": null,
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "feedback",
      "subcommands": [
        {
          "about": "Report a bug",
          "arguments": [
            {
              "help": "Bug description",
              "id": "description",
              "long": null,
              "required": false,
              "short": null
            },
            {
              "help": "Include recent logs with the report",
              "id": "include_logs",
              "long": "include-logs",
              "required": false,
              "short": null
            },
            {
              "help": "Session ID to attach to the bug report",
              "id": "session",
              "long": "session",
              "required": false,
              "short": "s"
            },
            {
              "help": "Output as JSON (for scripting)",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "bug",
          "subcommands": []
        },
        {
          "about": "Report a good AI result",
          "arguments": [
            {
              "help": "Comment about the result",
              "id": "comment",
              "long": null,
              "required": false,
              "short": null
            },
            {
              "help": "Session ID to attach",
              "id": "session",
              "long": "session",
              "required": false,
              "short": "s"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "good",
          "subcommands": []
        },
        {
          "about": "Report a bad AI result",
          "arguments": [
            {
              "help": "Comment about the result",
              "id": "comment",
              "long": null,
              "required": false,
              "short": null
            },
            {
              "help": "Session ID to attach",
              "id": "session",
              "long": "session",
              "required": false,
              "short": "s"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "bad",
          "subcommands": []
        },
        {
          "about": "Submit general feedback",
          "arguments": [
            {
              "help": "Feedback message",
              "id": "message",
              "long": null,
              "required": false,
              "short": null
            },
            {
              "help": "Include recent logs",
              "id": "include_logs",
              "long": "include-logs",
              "required": false,
              "short": null
            },
            {
              "help": "Session ID to attach",
              "id": "session",
              "long": "session",
              "required": false,
              "short": "s"
            },
            {
              "help": "Feedback category",
              "id": "category",
              "long": "category",
              "required": false,
              "short": "c"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "submit",
          "subcommands": []
        },
        {
          "about": "View feedback history",
          "arguments": [
            {
              "help": "Number of entries to show",
              "id": "limit",
              "long": "limit",
              "required": false,
              "short": "n"
            },
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "history",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "Report a bug",
              "arguments": [],
              "name": "bug",
              "subcommands": []
            },
            {
              "about": "Report a good AI result",
              "arguments": [],
              "name": "good",
              "subcommands": []
            },
            {
              "about": "Report a bad AI result",
              "arguments": [],
              "name": "bad",
              "subcommands": []
            },
            {
              "about": "Submit general feedback",
              "arguments": [],
              "name": "submit",
              "subcommands": []
            },
            {
              "about": "View feedback history",
              "arguments": [],
              "name": "history",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "Lock/protect sessions from deletion",
      "arguments": [
        {
          "help": "Session ID to lock (if no subcommand)",
          "id": "session_id",
          "long": null,
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "lock",
      "subcommands": [
        {
          "about": "Lock a session",
          "arguments": [
            {
              "help": "Session ID(s) to lock",
              "id": "session_ids",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Reason for locking",
              "id": "reason",
              "long": "reason",
              "required": false,
              "short": "r"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "add",
          "subcommands": []
        },
        {
          "about": "Unlock a session",
          "arguments": [
            {
              "help": "Session ID(s) to unlock",
              "id": "session_ids",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Skip confirmation prompt",
              "id": "yes",
              "long": "yes",
              "required": false,
              "short": "y"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "remove",
          "subcommands": []
        },
        {
          "about": "List locked sessions",
          "arguments": [
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "list",
          "subcommands": []
        },
        {
          "about": "Check if a session is locked",
          "arguments": [
            {
              "help": "Session ID to check",
              "id": "session_id",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "check",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "Lock a session",
              "arguments": [],
              "name": "add",
              "subcommands": []
            },
            {
              "about": "Unlock a session",
              "arguments": [],
              "name": "remove",
              "subcommands": []
            },
            {
              "about": "List locked sessions",
              "arguments": [],
              "name": "list",
              "subcommands": []
            },
            {
              "about": "Check if a session is locked",
              "arguments": [],
              "name": "check",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "Manage command aliases",
      "arguments": [
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "alias",
      "subcommands": [
        {
          "about": "Set a command alias",
          "arguments": [
            {
              "help": "Alias name (short name for the command)",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Command to alias (e.g., \"exec --output-schema\")",
              "id": "command",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Description of the alias",
              "id": "description",
              "long": "description",
              "required": false,
              "short": "d"
            },
            {
              "help": "Force overwrite if alias already exists",
              "id": "force",
              "long": "force",
              "required": false,
              "short": "f"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "set",
          "subcommands": []
        },
        {
          "about": "List all aliases",
          "arguments": [
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "list",
          "subcommands": []
        },
        {
          "about": "Remove an alias",
          "arguments": [
            {
              "help": "Alias name to remove",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Skip confirmation prompt",
              "id": "yes",
              "long": "yes",
              "required": false,
              "short": "y"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "remove",
          "subcommands": []
        },
        {
          "about": "Show alias details",
          "arguments": [
            {
              "help": "Alias name to show",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "show",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "Set a command alias",
              "arguments": [],
              "name": "set",
              "subcommands": []
            },
            {
              "about": "List all aliases",
              "arguments": [],
              "name": "list",
              "subcommands": []
            },
            {
              "about": "Remove an alias",
              "arguments": [],
              "name": "remove",
              "subcommands": []
            },
            {
              "about": "Show alias details",
              "arguments": [],
              "name": "show",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "Manage plugins",
      "arguments": [
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "plugin",
      "subcommands": [
        {
          "about": "List installed plugins",
          "arguments": [
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Show only enabled plugins",
              "id": "enabled",
              "long": "enabled",
              "required": false,
              "short": null
            },
            {
              "help": "Show only disabled plugins",
              "id": "disabled",
              "long": "disabled",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "list",
          "subcommands": []
        },
        {
          "about": "Install a plugin",
          "arguments": [
            {
              "help": "Trust this exact package to execute native Node code (NOT a sandbox)",
              "id": "trust_code",
              "long": "trust-code",
              "required": false,
              "short": null
            },
            {
              "help": "Local package path or registry plugin ID",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Plugin version (defaults to latest)",
              "id": "version",
              "long": "version",
              "required": false,
              "short": null
            },
            {
              "help": "Force reinstall if already installed",
              "id": "force",
              "long": "force",
              "required": false,
              "short": "f"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "install",
          "subcommands": []
        },
        {
          "about": "Remove a plugin",
          "arguments": [
            {
              "help": "Plugin name to remove",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Skip confirmation prompt",
              "id": "yes",
              "long": "yes",
              "required": false,
              "short": "y"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "remove",
          "subcommands": []
        },
        {
          "about": "Enable a plugin",
          "arguments": [
            {
              "help": "Plugin name to enable",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "enable",
          "subcommands": []
        },
        {
          "about": "Disable a plugin",
          "arguments": [
            {
              "help": "Plugin name to disable",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "disable",
          "subcommands": []
        },
        {
          "about": "Show plugin information",
          "arguments": [
            {
              "help": "Plugin name to show",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "show",
          "subcommands": []
        },
        {
          "about": "Create a new plugin project",
          "arguments": [
            {
              "help": "Plugin name (will be used as directory name and ID)",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Plugin description",
              "id": "description",
              "long": "description",
              "required": false,
              "short": "d"
            },
            {
              "help": "Plugin author",
              "id": "author",
              "long": "author",
              "required": false,
              "short": "a"
            },
            {
              "help": "Output directory (defaults to current directory)",
              "id": "output",
              "long": "output",
              "required": false,
              "short": "o"
            },
            {
              "help": "Use advanced template with TUI hooks",
              "id": "advanced",
              "long": "advanced",
              "required": false,
              "short": null
            },
            {
              "help": "Use TypeScript template instead of Rust",
              "id": "typescript",
              "long": "typescript",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "new",
          "subcommands": []
        },
        {
          "about": "Rebuild in development mode (no runtime hot-reload)",
          "arguments": [
            {
              "help": "Plugin directory (defaults to current directory)",
              "id": "path",
              "long": "path",
              "required": false,
              "short": "p"
            },
            {
              "help": "Watch for file changes and auto-rebuild",
              "id": "watch",
              "long": "watch",
              "required": false,
              "short": "w"
            },
            {
              "help": "Debounce time in milliseconds for file change events",
              "id": "debounce_ms",
              "long": "debounce-ms",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "dev",
          "subcommands": []
        },
        {
          "about": "Build the selected executable artifact",
          "arguments": [
            {
              "help": "Allow native Rust build scripts/procedural macros; not needed for TypeScript stripping",
              "id": "trust_code",
              "long": "trust-code",
              "required": false,
              "short": null
            },
            {
              "help": "Plugin directory (defaults to current directory)",
              "id": "path",
              "long": "path",
              "required": false,
              "short": "p"
            },
            {
              "help": "Build in debug mode (faster, larger output)",
              "id": "debug",
              "long": "debug",
              "required": false,
              "short": null
            },
            {
              "help": "Output directory for the compiled WASM file",
              "id": "output",
              "long": "output",
              "required": false,
              "short": "o"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "build",
          "subcommands": []
        },
        {
          "about": "Validate plugin manifest and structure",
          "arguments": [
            {
              "help": "Plugin directory (defaults to current directory)",
              "id": "path",
              "long": "path",
              "required": false,
              "short": "p"
            },
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Show verbose output with all checks",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "validate",
          "subcommands": []
        },
        {
          "about": "Prepare plugin for publication (dry-run)",
          "arguments": [
            {
              "help": "Plugin directory (defaults to current directory)",
              "id": "path",
              "long": "path",
              "required": false,
              "short": "p"
            },
            {
              "help": "Dry-run mode (default, no actual publishing)",
              "id": "dry_run",
              "long": "dry-run",
              "required": false,
              "short": null
            },
            {
              "help": "Output tarball path (defaults to plugin-name-version.tar.gz)",
              "id": "output",
              "long": "output",
              "required": false,
              "short": "o"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "publish",
          "subcommands": []
        },
        {
          "about": "Search the plugin registry",
          "arguments": [
            {
              "help": "Search query",
              "id": "query",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "search",
          "subcommands": []
        },
        {
          "about": "Browse plugins in the registry",
          "arguments": [
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "browse",
          "subcommands": []
        },
        {
          "about": "Update an installed plugin from the registry",
          "arguments": [
            {
              "help": "Local replacement package; otherwise use the registry",
              "id": "source",
              "long": "source",
              "required": false,
              "short": null
            },
            {
              "help": "Plugin name to update",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "update",
          "subcommands": []
        },
        {
          "about": "Explicitly trust native JavaScript execution for this installed artifact",
          "arguments": [
            {
              "help": null,
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Acknowledge that Node plugins can access files, network and subprocesses",
              "id": "yes",
              "long": "yes",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "trust",
          "subcommands": []
        },
        {
          "about": "Invoke an installed plugin command or tool through the executable runtime",
          "arguments": [
            {
              "help": null,
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": null,
              "id": "command",
              "long": null,
              "required": false,
              "short": null
            },
            {
              "help": null,
              "id": "args",
              "long": null,
              "required": false,
              "short": null
            },
            {
              "help": null,
              "id": "tool",
              "long": "tool",
              "required": false,
              "short": null
            },
            {
              "help": null,
              "id": "input",
              "long": "input",
              "required": false,
              "short": null
            },
            {
              "help": null,
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "run",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "List installed plugins",
              "arguments": [],
              "name": "list",
              "subcommands": []
            },
            {
              "about": "Install a plugin",
              "arguments": [],
              "name": "install",
              "subcommands": []
            },
            {
              "about": "Remove a plugin",
              "arguments": [],
              "name": "remove",
              "subcommands": []
            },
            {
              "about": "Enable a plugin",
              "arguments": [],
              "name": "enable",
              "subcommands": []
            },
            {
              "about": "Disable a plugin",
              "arguments": [],
              "name": "disable",
              "subcommands": []
            },
            {
              "about": "Show plugin information",
              "arguments": [],
              "name": "show",
              "subcommands": []
            },
            {
              "about": "Create a new plugin project",
              "arguments": [],
              "name": "new",
              "subcommands": []
            },
            {
              "about": "Rebuild in development mode (no runtime hot-reload)",
              "arguments": [],
              "name": "dev",
              "subcommands": []
            },
            {
              "about": "Build the selected executable artifact",
              "arguments": [],
              "name": "build",
              "subcommands": []
            },
            {
              "about": "Validate plugin manifest and structure",
              "arguments": [],
              "name": "validate",
              "subcommands": []
            },
            {
              "about": "Prepare plugin for publication (dry-run)",
              "arguments": [],
              "name": "publish",
              "subcommands": []
            },
            {
              "about": "Search the plugin registry",
              "arguments": [],
              "name": "search",
              "subcommands": []
            },
            {
              "about": "Browse plugins in the registry",
              "arguments": [],
              "name": "browse",
              "subcommands": []
            },
            {
              "about": "Update an installed plugin from the registry",
              "arguments": [],
              "name": "update",
              "subcommands": []
            },
            {
              "about": "Explicitly trust native JavaScript execution for this installed artifact",
              "arguments": [],
              "name": "trust",
              "subcommands": []
            },
            {
              "about": "Invoke an installed plugin command or tool through the executable runtime",
              "arguments": [],
              "name": "run",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "Debug and diagnostic commands",
      "arguments": [
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "debug",
      "subcommands": [
        {
          "about": "Check local configuration, storage, and required tools without network access",
          "arguments": [
            {
              "help": "Output the checks as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "doctor",
          "subcommands": []
        },
        {
          "about": "Show resolved configuration and config file locations",
          "arguments": [
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Show environment variables related to Cortex",
              "id": "env",
              "long": "env",
              "required": false,
              "short": null
            },
            {
              "help": "Show diff between local project config and global config",
              "id": "diff",
              "long": "diff",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "config",
          "subcommands": []
        },
        {
          "about": "Show file metadata, MIME type, and encoding",
          "arguments": [
            {
              "help": "Path to the file to inspect",
              "id": "path",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "file",
          "subcommands": []
        },
        {
          "about": "List and test LSP servers",
          "arguments": [
            {
              "help": "Test a specific LSP server",
              "id": "server",
              "long": "server",
              "required": false,
              "short": null
            },
            {
              "help": "Filter by programming language (e.g., python, rust, go)",
              "id": "language",
              "long": "language",
              "required": false,
              "short": "l"
            },
            {
              "help": "Test LSP connection for a specific file",
              "id": "file",
              "long": "file",
              "required": false,
              "short": null
            },
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "lsp",
          "subcommands": []
        },
        {
          "about": "Check ripgrep availability and test search",
          "arguments": [
            {
              "help": "Test search with a pattern",
              "id": "test",
              "long": "test",
              "required": false,
              "short": null
            },
            {
              "help": "Directory to search in for test",
              "id": "dir",
              "long": "dir",
              "required": false,
              "short": null
            },
            {
              "help": "Offer to install ripgrep if not found",
              "id": "install",
              "long": "install",
              "required": false,
              "short": null
            },
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "ripgrep",
          "subcommands": []
        },
        {
          "about": "Parse and validate a skill file",
          "arguments": [
            {
              "help": "Name or path of the skill to validate",
              "id": "name",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "skill",
          "subcommands": []
        },
        {
          "about": "Show snapshot status and diffs",
          "arguments": [
            {
              "help": "Session ID to inspect snapshots for",
              "id": "session",
              "long": "session",
              "required": false,
              "short": null
            },
            {
              "help": "Show diff between snapshots",
              "id": "diff",
              "long": "diff",
              "required": false,
              "short": null
            },
            {
              "help": "Create a new snapshot of the current workspace state",
              "id": "create",
              "long": "create",
              "required": false,
              "short": null
            },
            {
              "help": "Restore workspace to a specific snapshot state. Requires --snapshot-id to specify which snapshot to restore",
              "id": "restore",
              "long": "restore",
              "required": false,
              "short": null
            },
            {
              "help": "Delete a specific snapshot. Requires --snapshot-id to specify which snapshot to delete",
              "id": "delete",
              "long": "delete",
              "required": false,
              "short": null
            },
            {
              "help": "Snapshot ID for restore/delete operations",
              "id": "snapshot_id",
              "long": "snapshot-id",
              "required": false,
              "short": null
            },
            {
              "help": "Description for the snapshot (used with --create)",
              "id": "description",
              "long": "description",
              "required": false,
              "short": null
            },
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "snapshot",
          "subcommands": []
        },
        {
          "about": "Show all Cortex paths",
          "arguments": [
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Check if write locations are accessible (useful for Docker read-only containers)",
              "id": "check_writable",
              "long": "check-writable",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "paths",
          "subcommands": []
        },
        {
          "about": "Show system information (OS, architecture, shell, etc.) for bug reports",
          "arguments": [
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "system",
          "subcommands": []
        },
        {
          "about": "Wait for a condition (useful for scripts)",
          "arguments": [
            {
              "help": "Wait for LSP to be ready",
              "id": "lsp_ready",
              "long": "lsp-ready",
              "required": false,
              "short": null
            },
            {
              "help": "Wait for server to be ready",
              "id": "server_ready",
              "long": "server-ready",
              "required": false,
              "short": null
            },
            {
              "help": "Server URL to check (default: http://127.0.0.1:3000)",
              "id": "server_url",
              "long": "server-url",
              "required": false,
              "short": null
            },
            {
              "help": "Wait for a TCP port to be available",
              "id": "port",
              "long": "port",
              "required": false,
              "short": null
            },
            {
              "help": "Host to check when using --port (default: 127.0.0.1)",
              "id": "host",
              "long": "host",
              "required": false,
              "short": null
            },
            {
              "help": "Timeout in seconds",
              "id": "timeout",
              "long": "timeout",
              "required": false,
              "short": null
            },
            {
              "help": "Check interval in milliseconds",
              "id": "interval",
              "long": "interval",
              "required": false,
              "short": null
            },
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "wait",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "Check local configuration, storage, and required tools without network access",
              "arguments": [],
              "name": "doctor",
              "subcommands": []
            },
            {
              "about": "Show resolved configuration and config file locations",
              "arguments": [],
              "name": "config",
              "subcommands": []
            },
            {
              "about": "Show file metadata, MIME type, and encoding",
              "arguments": [],
              "name": "file",
              "subcommands": []
            },
            {
              "about": "List and test LSP servers",
              "arguments": [],
              "name": "lsp",
              "subcommands": []
            },
            {
              "about": "Check ripgrep availability and test search",
              "arguments": [],
              "name": "ripgrep",
              "subcommands": []
            },
            {
              "about": "Parse and validate a skill file",
              "arguments": [],
              "name": "skill",
              "subcommands": []
            },
            {
              "about": "Show snapshot status and diffs",
              "arguments": [],
              "name": "snapshot",
              "subcommands": []
            },
            {
              "about": "Show all Cortex paths",
              "arguments": [],
              "name": "paths",
              "subcommands": []
            },
            {
              "about": "Show system information (OS, architecture, shell, etc.) for bug reports",
              "arguments": [],
              "name": "system",
              "subcommands": []
            },
            {
              "about": "Wait for a condition (useful for scripts)",
              "arguments": [],
              "name": "wait",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "Start interactive shell/REPL mode",
      "arguments": [
        {
          "help": "Model to use (e.g., claude-sonnet-4-20250514, gpt-4o)",
          "id": "model",
          "long": "model",
          "required": false,
          "short": "m"
        },
        {
          "help": "Working directory override",
          "id": "cwd",
          "long": "cwd",
          "required": false,
          "short": "C"
        },
        {
          "help": "Configuration profile from config.toml",
          "id": "config_profile",
          "long": "profile",
          "required": false,
          "short": "p"
        },
        {
          "help": "Enable web search capability",
          "id": "web_search",
          "long": "search",
          "required": false,
          "short": null
        },
        {
          "help": "Initial prompt to start the session with",
          "id": "prompt",
          "long": null,
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "shell",
      "subcommands": []
    },
    {
      "about": "Execute and manage task DAGs (dependency graphs)",
      "arguments": [
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "dag",
      "subcommands": [
        {
          "about": "Create a new task DAG from a specification file",
          "arguments": [
            {
              "help": "Path to task specification file (YAML or JSON)",
              "id": "file",
              "long": "file",
              "required": true,
              "short": "f"
            },
            {
              "help": "Custom DAG ID (generated if not provided)",
              "id": "id",
              "long": "id",
              "required": false,
              "short": "i"
            },
            {
              "help": "Validate only, don't save",
              "id": "dry_run",
              "long": "dry-run",
              "required": false,
              "short": null
            },
            {
              "help": "Output format",
              "id": "format",
              "long": "format",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "create",
          "subcommands": []
        },
        {
          "about": "Execute a task DAG",
          "arguments": [
            {
              "help": "Path to task specification file (YAML or JSON)",
              "id": "file",
              "long": "file",
              "required": true,
              "short": "f"
            },
            {
              "help": "Maximum concurrent tasks",
              "id": "max_concurrent",
              "long": "jobs",
              "required": false,
              "short": "j"
            },
            {
              "help": "Task timeout in seconds",
              "id": "timeout",
              "long": "timeout",
              "required": false,
              "short": "t"
            },
            {
              "help": "Execution strategy",
              "id": "strategy",
              "long": "strategy",
              "required": false,
              "short": "s"
            },
            {
              "help": "Failure handling mode",
              "id": "failure_mode",
              "long": "on-failure",
              "required": false,
              "short": null
            },
            {
              "help": "Output format",
              "id": "format",
              "long": "format",
              "required": false,
              "short": null
            },
            {
              "help": "Quiet mode - minimal output",
              "id": "quiet",
              "long": "quiet",
              "required": false,
              "short": "q"
            },
            {
              "help": "Verbose mode - show task details",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Save DAG state for later resume",
              "id": "save",
              "long": "save",
              "required": false,
              "short": null
            },
            {
              "help": "Custom DAG ID for saving",
              "id": "id",
              "long": "id",
              "required": false,
              "short": null
            },
            {
              "help": "Infer task dependencies from affected files",
              "id": "infer_deps",
              "long": "infer-deps",
              "required": false,
              "short": null
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "run",
          "subcommands": []
        },
        {
          "about": "Show the status of a DAG",
          "arguments": [
            {
              "help": "DAG ID to check",
              "id": "id",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Output format",
              "id": "format",
              "long": "format",
              "required": false,
              "short": null
            },
            {
              "help": "Show detailed task information",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "status",
          "subcommands": []
        },
        {
          "about": "List all DAGs",
          "arguments": [
            {
              "help": "Filter by status (pending, running, completed, failed)",
              "id": "status",
              "long": "status",
              "required": false,
              "short": null
            },
            {
              "help": "Output format",
              "id": "format",
              "long": "format",
              "required": false,
              "short": null
            },
            {
              "help": "Maximum number of DAGs to show",
              "id": "limit",
              "long": "limit",
              "required": false,
              "short": "n"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "list",
          "subcommands": []
        },
        {
          "about": "Validate a DAG specification",
          "arguments": [
            {
              "help": "Path to task specification file",
              "id": "file",
              "long": "file",
              "required": true,
              "short": "f"
            },
            {
              "help": "Show validation details",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "validate",
          "subcommands": []
        },
        {
          "about": "Visualize a DAG structure",
          "arguments": [
            {
              "help": "Path to task specification file",
              "id": "file",
              "long": "file",
              "required": true,
              "short": "f"
            },
            {
              "help": "Output format (ascii, dot, mermaid)",
              "id": "output",
              "long": "output",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "graph",
          "subcommands": []
        },
        {
          "about": "Delete a DAG",
          "arguments": [
            {
              "help": "DAG ID to delete",
              "id": "id",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Skip confirmation prompt",
              "id": "yes",
              "long": "yes",
              "required": false,
              "short": "y"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "delete",
          "subcommands": []
        },
        {
          "about": "Resume a partially executed DAG",
          "arguments": [
            {
              "help": "DAG ID to resume",
              "id": "id",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Maximum concurrent tasks",
              "id": "max_concurrent",
              "long": "jobs",
              "required": false,
              "short": "j"
            },
            {
              "help": "Task timeout in seconds",
              "id": "timeout",
              "long": "timeout",
              "required": false,
              "short": "t"
            },
            {
              "help": "Failure handling mode",
              "id": "failure_mode",
              "long": "on-failure",
              "required": false,
              "short": null
            },
            {
              "help": "Output format",
              "id": "format",
              "long": "format",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "resume",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "Create a new task DAG from a specification file",
              "arguments": [],
              "name": "create",
              "subcommands": []
            },
            {
              "about": "Execute a task DAG",
              "arguments": [],
              "name": "run",
              "subcommands": []
            },
            {
              "about": "Show the status of a DAG",
              "arguments": [],
              "name": "status",
              "subcommands": []
            },
            {
              "about": "List all DAGs",
              "arguments": [],
              "name": "list",
              "subcommands": []
            },
            {
              "about": "Validate a DAG specification",
              "arguments": [],
              "name": "validate",
              "subcommands": []
            },
            {
              "about": "Visualize a DAG structure",
              "arguments": [],
              "name": "graph",
              "subcommands": []
            },
            {
              "about": "Delete a DAG",
              "arguments": [],
              "name": "delete",
              "subcommands": []
            },
            {
              "about": "Resume a partially executed DAG",
              "arguments": [],
              "name": "resume",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "Discover Cortex servers on the local network",
      "arguments": [
        {
          "help": "Timeout for discovery in seconds",
          "id": "timeout",
          "long": "timeout",
          "required": false,
          "short": "t"
        },
        {
          "help": "Output in JSON format",
          "id": "json",
          "long": "json",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "servers",
      "subcommands": [
        {
          "about": "Re-scan the network for mDNS servers (forces a fresh discovery)",
          "arguments": [
            {
              "help": "Timeout for discovery in seconds",
              "id": "timeout",
              "long": "timeout",
              "required": false,
              "short": "t"
            },
            {
              "help": "Output in JSON format",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "refresh",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "Re-scan the network for mDNS servers (forces a fresh discovery)",
              "arguments": [],
              "name": "refresh",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "View prompt history from past sessions",
      "arguments": [
        {
          "help": "Maximum number of entries to show",
          "id": "limit",
          "long": "limit",
          "required": false,
          "short": "n"
        },
        {
          "help": "Show history from all directories",
          "id": "all",
          "long": "all",
          "required": false,
          "short": null
        },
        {
          "help": "Output in JSON format",
          "id": "json",
          "long": "json",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "history",
      "subcommands": [
        {
          "about": "Search history for a pattern",
          "arguments": [
            {
              "help": "Pattern to search for in prompts",
              "id": "pattern",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Maximum number of results",
              "id": "limit",
              "long": "limit",
              "required": false,
              "short": "n"
            },
            {
              "help": "Output in JSON format",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "search",
          "subcommands": []
        },
        {
          "about": "Clear history (requires confirmation)",
          "arguments": [
            {
              "help": "Skip confirmation prompt",
              "id": "yes",
              "long": "yes",
              "required": false,
              "short": "y"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "clear",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "Search history for a pattern",
              "arguments": [],
              "name": "search",
              "subcommands": []
            },
            {
              "about": "Clear history (requires confirmation)",
              "arguments": [],
              "name": "clear",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "Manage workspace/project settings",
      "arguments": [
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "workspace",
      "subcommands": [
        {
          "about": "Show workspace information",
          "arguments": [
            {
              "help": "Output as JSON",
              "id": "json",
              "long": "json",
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "show",
          "subcommands": []
        },
        {
          "about": "Initialize workspace configuration",
          "arguments": [
            {
              "help": "Force overwrite if config already exists",
              "id": "force",
              "long": "force",
              "required": false,
              "short": "f"
            },
            {
              "help": "Template to use (minimal, default, full)",
              "id": "template",
              "long": "template",
              "required": false,
              "short": "t"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "init",
          "subcommands": []
        },
        {
          "about": "Set workspace settings",
          "arguments": [
            {
              "help": "Configuration key to set",
              "id": "key",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Value to set",
              "id": "value",
              "long": null,
              "required": true,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "set",
          "subcommands": []
        },
        {
          "about": "Open workspace configuration in editor",
          "arguments": [
            {
              "help": "Editor to use (defaults to $EDITOR or $VISUAL)",
              "id": "editor",
              "long": "editor",
              "required": false,
              "short": "e"
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "edit",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "Show workspace information",
              "arguments": [],
              "name": "show",
              "subcommands": []
            },
            {
              "about": "Initialize workspace configuration",
              "arguments": [],
              "name": "init",
              "subcommands": []
            },
            {
              "about": "Set workspace settings",
              "arguments": [],
              "name": "set",
              "subcommands": []
            },
            {
              "about": "Open workspace configuration in editor",
              "arguments": [],
              "name": "edit",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "Run commands within a Cortex-provided sandbox",
      "arguments": [
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "sandbox",
      "subcommands": [
        {
          "about": "Run a command under Seatbelt (macOS only)",
          "arguments": [
            {
              "help": "Convenience alias for low-friction sandboxed automatic execution",
              "id": "full_auto",
              "long": "full-auto",
              "required": false,
              "short": null
            },
            {
              "help": "While the command runs, capture macOS sandbox denials",
              "id": "log_denials",
              "long": "log-denials",
              "required": false,
              "short": null
            },
            {
              "help": "Full command args to run under seatbelt",
              "id": "command",
              "long": null,
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "macos",
          "subcommands": []
        },
        {
          "about": "Run a command under Landlock+seccomp (Linux only)",
          "arguments": [
            {
              "help": "Convenience alias for low-friction sandboxed automatic execution",
              "id": "full_auto",
              "long": "full-auto",
              "required": false,
              "short": null
            },
            {
              "help": "Full command args to run under landlock",
              "id": "command",
              "long": null,
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "linux",
          "subcommands": []
        },
        {
          "about": "Run a command under Windows restricted token (Windows only)",
          "arguments": [
            {
              "help": "Convenience alias for low-friction sandboxed automatic execution",
              "id": "full_auto",
              "long": "full-auto",
              "required": false,
              "short": null
            },
            {
              "help": "Full command args to run under Windows restricted token sandbox",
              "id": "command",
              "long": null,
              "required": false,
              "short": null
            },
            {
              "help": "Enable verbose output (same as --log-level debug)",
              "id": "verbose",
              "long": "verbose",
              "required": false,
              "short": "v"
            },
            {
              "help": "Enable trace-level logging for debugging",
              "id": "trace",
              "long": "trace",
              "required": false,
              "short": null
            },
            {
              "help": "Control color output: auto (default), always, or never",
              "id": "color",
              "long": "color",
              "required": false,
              "short": null
            },
            {
              "help": "Print help (see more with '--help')",
              "id": "help",
              "long": "help",
              "required": false,
              "short": "h"
            }
          ],
          "name": "windows",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": [
            {
              "about": "Run a command under Seatbelt (macOS only)",
              "arguments": [],
              "name": "macos",
              "subcommands": []
            },
            {
              "about": "Run a command under Landlock+seccomp (Linux only)",
              "arguments": [],
              "name": "linux",
              "subcommands": []
            },
            {
              "about": "Run a command under Windows restricted token (Windows only)",
              "arguments": [],
              "name": "windows",
              "subcommands": []
            },
            {
              "about": "Print this message or the help of the given subcommand(s)",
              "arguments": [],
              "name": "help",
              "subcommands": []
            }
          ]
        }
      ]
    },
    {
      "about": "Run the HTTP API server (for desktop/web integration)",
      "arguments": [
        {
          "help": "Port to listen on",
          "id": "port",
          "long": "port",
          "required": false,
          "short": "p"
        },
        {
          "help": "Host address to bind the server to",
          "id": "host",
          "long": "host",
          "required": false,
          "short": null
        },
        {
          "help": "Authentication token for API access",
          "id": "auth_token",
          "long": "auth-token",
          "required": false,
          "short": null
        },
        {
          "help": "Enable CORS (Cross-Origin Resource Sharing) for all origins",
          "id": "cors",
          "long": "cors",
          "required": false,
          "short": null
        },
        {
          "help": "Allowed CORS origin(s). Can be specified multiple times",
          "id": "cors_origins",
          "long": "cors-origin",
          "required": false,
          "short": null
        },
        {
          "help": "Enable mDNS service discovery (advertise on local network)",
          "id": "mdns",
          "long": "mdns",
          "required": false,
          "short": null
        },
        {
          "help": "Disable mDNS service discovery",
          "id": "no_mdns",
          "long": "no-mdns",
          "required": false,
          "short": null
        },
        {
          "help": "Custom service name for mDNS advertising",
          "id": "mdns_name",
          "long": "mdns-name",
          "required": false,
          "short": null
        },
        {
          "help": "Enable verbose output (same as --log-level debug)",
          "id": "verbose",
          "long": "verbose",
          "required": false,
          "short": "v"
        },
        {
          "help": "Enable trace-level logging for debugging",
          "id": "trace",
          "long": "trace",
          "required": false,
          "short": null
        },
        {
          "help": "Control color output: auto (default), always, or never",
          "id": "color",
          "long": "color",
          "required": false,
          "short": null
        },
        {
          "help": "Print help (see more with '--help')",
          "id": "help",
          "long": "help",
          "required": false,
          "short": "h"
        }
      ],
      "name": "serve",
      "subcommands": []
    },
    {
      "about": "Print this message or the help of the given subcommand(s)",
      "arguments": [],
      "name": "help",
      "subcommands": [
        {
          "about": "Run Cortex non-interactively with advanced options",
          "arguments": [],
          "name": "run",
          "subcommands": []
        },
        {
          "about": "Execute in headless mode (for CI/CD, scripts, automation)",
          "arguments": [],
          "name": "exec",
          "subcommands": []
        },
        {
          "about": "Resume a previous interactive session",
          "arguments": [],
          "name": "resume",
          "subcommands": []
        },
        {
          "about": "List previous sessions",
          "arguments": [],
          "name": "sessions",
          "subcommands": []
        },
        {
          "about": "Export a session to JSON format",
          "arguments": [],
          "name": "export",
          "subcommands": []
        },
        {
          "about": "Import a session from JSON file or URL",
          "arguments": [],
          "name": "import",
          "subcommands": []
        },
        {
          "about": "Delete a session",
          "arguments": [],
          "name": "delete",
          "subcommands": []
        },
        {
          "about": "Authenticate with Cortex API",
          "arguments": [],
          "name": "login",
          "subcommands": [
            {
              "about": "Show login status",
              "arguments": [],
              "name": "status",
              "subcommands": []
            }
          ]
        },
        {
          "about": "Remove stored authentication credentials",
          "arguments": [],
          "name": "logout",
          "subcommands": []
        },
        {
          "about": "Show currently authenticated user",
          "arguments": [],
          "name": "whoami",
          "subcommands": []
        },
        {
          "about": "Manage agents (list, create, show)",
          "arguments": [],
          "name": "agent",
          "subcommands": [
            {
              "about": "List all available agents",
              "arguments": [],
              "name": "list",
              "subcommands": []
            },
            {
              "about": "Show details for a specific agent",
              "arguments": [],
              "name": "show",
              "subcommands": []
            },
            {
              "about": "Create a new agent interactively",
              "arguments": [],
              "name": "create",
              "subcommands": []
            },
            {
              "about": "Edit an existing agent in your default editor",
              "arguments": [],
              "name": "edit",
              "subcommands": []
            },
            {
              "about": "Remove a user-defined agent",
              "arguments": [],
              "name": "remove",
              "subcommands": []
            },
            {
              "about": "Install an agent from the registry",
              "arguments": [],
              "name": "install",
              "subcommands": []
            },
            {
              "about": "Copy/clone an existing agent with a new name",
              "arguments": [],
              "name": "copy",
              "subcommands": []
            },
            {
              "about": "Export an agent definition to stdout or a file",
              "arguments": [],
              "name": "export",
              "subcommands": []
            }
          ]
        },
        {
          "about": "Manage MCP (Model Context Protocol) servers",
          "arguments": [],
          "name": "mcp",
          "subcommands": [
            {
              "about": "List configured MCP servers",
              "arguments": [],
              "name": "list",
              "subcommands": []
            },
            {
              "about": "Show details for a configured MCP server",
              "arguments": [],
              "name": "get",
              "subcommands": []
            },
            {
              "about": "Add a global MCP server entry",
              "arguments": [],
              "name": "add",
              "subcommands": []
            },
            {
              "about": "Remove a global MCP server entry",
              "arguments": [],
              "name": "remove",
              "subcommands": []
            },
            {
              "about": "Enable a disabled MCP server",
              "arguments": [],
              "name": "enable",
              "subcommands": []
            },
            {
              "about": "Disable an MCP server without removing it",
              "arguments": [],
              "name": "disable",
              "subcommands": []
            },
            {
              "about": "Rename an MCP server",
              "arguments": [],
              "name": "rename",
              "subcommands": []
            },
            {
              "about": "Authenticate with an OAuth-enabled MCP server",
              "arguments": [],
              "name": "auth",
              "subcommands": [
                {
                  "about": "List OAuth status for all servers",
                  "arguments": [],
                  "name": "list",
                  "subcommands": []
                }
              ]
            },
            {
              "about": "Remove OAuth credentials for an MCP server",
              "arguments": [],
              "name": "logout",
              "subcommands": []
            },
            {
              "about": "Debug and test an MCP server connection",
              "arguments": [],
              "name": "debug",
              "subcommands": []
            },
            {
              "about": "List tools exposed by a configured MCP server",
              "arguments": [],
              "name": "tools",
              "subcommands": []
            }
          ]
        },
        {
          "about": "Run the MCP server (stdio transport)",
          "arguments": [],
          "name": "mcp-server",
          "subcommands": []
        },
        {
          "about": "Start ACP server for IDE integration (e.g., Zed)",
          "arguments": [],
          "name": "acp",
          "subcommands": []
        },
        {
          "about": "Show or edit configuration",
          "arguments": [],
          "name": "config",
          "subcommands": [
            {
              "about": "Get a configuration value",
              "arguments": [],
              "name": "get",
              "subcommands": []
            },
            {
              "about": "Set a configuration value",
              "arguments": [],
              "name": "set",
              "subcommands": []
            },
            {
              "about": "Unset (remove) a configuration value",
              "arguments": [],
              "name": "unset",
              "subcommands": []
            }
          ]
        },
        {
          "about": "List available models",
          "arguments": [],
          "name": "models",
          "subcommands": [
            {
              "about": "List all available models",
              "arguments": [],
              "name": "list",
              "subcommands": []
            }
          ]
        },
        {
          "about": "Inspect feature flags",
          "arguments": [],
          "name": "features",
          "subcommands": [
            {
              "about": "List known features with their stage and effective state",
              "arguments": [],
              "name": "list",
              "subcommands": []
            }
          ]
        },
        {
          "about": "Initialize AGENTS.md in the current directory",
          "arguments": [],
          "name": "init",
          "subcommands": []
        },
        {
          "about": "GitHub integration (actions, workflows)",
          "arguments": [],
          "name": "github",
          "subcommands": [
            {
              "about": "Install GitHub Actions workflow for Cortex CI/CD automation",
              "arguments": [],
              "name": "install",
              "subcommands": []
            },
            {
              "about": "Run GitHub agent in Actions context",
              "arguments": [],
              "name": "run",
              "subcommands": []
            },
            {
              "about": "Check GitHub Actions installation status",
              "arguments": [],
              "name": "status",
              "subcommands": []
            },
            {
              "about": "Uninstall/remove the Cortex GitHub workflow",
              "arguments": [],
              "name": "uninstall",
              "subcommands": []
            },
            {
              "about": "Update the Cortex GitHub workflow to the latest version",
              "arguments": [],
              "name": "update",
              "subcommands": []
            }
          ]
        },
        {
          "about": "Checkout a pull request",
          "arguments": [],
          "name": "pr",
          "subcommands": []
        },
        {
          "about": "Scrape web content to markdown/text/html",
          "arguments": [],
          "name": "scrape",
          "subcommands": []
        },
        {
          "about": "Show usage statistics",
          "arguments": [],
          "name": "stats",
          "subcommands": []
        },
        {
          "about": "Generate shell completion scripts",
          "arguments": [],
          "name": "completion",
          "subcommands": []
        },
        {
          "about": "Check for and install updates",
          "arguments": [],
          "name": "upgrade",
          "subcommands": []
        },
        {
          "about": "Uninstall Cortex CLI",
          "arguments": [],
          "name": "uninstall",
          "subcommands": []
        },
        {
          "about": "Data compaction and cleanup (logs, sessions, history)",
          "arguments": [],
          "name": "compact",
          "subcommands": [
            {
              "about": "Run a compaction cycle (logs + sessions)",
              "arguments": [],
              "name": "run",
              "subcommands": []
            },
            {
              "about": "Prune old log files",
              "arguments": [],
              "name": "logs",
              "subcommands": []
            },
            {
              "about": "Vacuum session database (clean orphaned files)",
              "arguments": [],
              "name": "vacuum",
              "subcommands": []
            },
            {
              "about": "Show compaction status and statistics",
              "arguments": [],
              "name": "status",
              "subcommands": []
            },
            {
              "about": "Configure auto-compaction settings",
              "arguments": [],
              "name": "config",
              "subcommands": []
            }
          ]
        },
        {
          "about": "Manage cache",
          "arguments": [],
          "name": "cache",
          "subcommands": [
            {
              "about": "Show cache information and statistics",
              "arguments": [],
              "name": "show",
              "subcommands": []
            },
            {
              "about": "Clear all or part of the cache",
              "arguments": [],
              "name": "clear",
              "subcommands": []
            },
            {
              "about": "Show cache size",
              "arguments": [],
              "name": "size",
              "subcommands": []
            },
            {
              "about": "List cached items",
              "arguments": [],
              "name": "list",
              "subcommands": []
            }
          ]
        },
        {
          "about": "View application logs",
          "arguments": [],
          "name": "logs",
          "subcommands": []
        },
        {
          "about": "Submit feedback and bug reports",
          "arguments": [],
          "name": "feedback",
          "subcommands": [
            {
              "about": "Report a bug",
              "arguments": [],
              "name": "bug",
              "subcommands": []
            },
            {
              "about": "Report a good AI result",
              "arguments": [],
              "name": "good",
              "subcommands": []
            },
            {
              "about": "Report a bad AI result",
              "arguments": [],
              "name": "bad",
              "subcommands": []
            },
            {
              "about": "Submit general feedback",
              "arguments": [],
              "name": "submit",
              "subcommands": []
            },
            {
              "about": "View feedback history",
              "arguments": [],
              "name": "history",
              "subcommands": []
            }
          ]
        },
        {
          "about": "Lock/protect sessions from deletion",
          "arguments": [],
          "name": "lock",
          "subcommands": [
            {
              "about": "Lock a session",
              "arguments": [],
              "name": "add",
              "subcommands": []
            },
            {
              "about": "Unlock a session",
              "arguments": [],
              "name": "remove",
              "subcommands": []
            },
            {
              "about": "List locked sessions",
              "arguments": [],
              "name": "list",
              "subcommands": []
            },
            {
              "about": "Check if a session is locked",
              "arguments": [],
              "name": "check",
              "subcommands": []
            }
          ]
        },
        {
          "about": "Manage command aliases",
          "arguments": [],
          "name": "alias",
          "subcommands": [
            {
              "about": "Set a command alias",
              "arguments": [],
              "name": "set",
              "subcommands": []
            },
            {
              "about": "List all aliases",
              "arguments": [],
              "name": "list",
              "subcommands": []
            },
            {
              "about": "Remove an alias",
              "arguments": [],
              "name": "remove",
              "subcommands": []
            },
            {
              "about": "Show alias details",
              "arguments": [],
              "name": "show",
              "subcommands": []
            }
          ]
        },
        {
          "about": "Manage plugins",
          "arguments": [],
          "name": "plugin",
          "subcommands": [
            {
              "about": "List installed plugins",
              "arguments": [],
              "name": "list",
              "subcommands": []
            },
            {
              "about": "Install a plugin",
              "arguments": [],
              "name": "install",
              "subcommands": []
            },
            {
              "about": "Remove a plugin",
              "arguments": [],
              "name": "remove",
              "subcommands": []
            },
            {
              "about": "Enable a plugin",
              "arguments": [],
              "name": "enable",
              "subcommands": []
            },
            {
              "about": "Disable a plugin",
              "arguments": [],
              "name": "disable",
              "subcommands": []
            },
            {
              "about": "Show plugin information",
              "arguments": [],
              "name": "show",
              "subcommands": []
            },
            {
              "about": "Create a new plugin project",
              "arguments": [],
              "name": "new",
              "subcommands": []
            },
            {
              "about": "Rebuild in development mode (no runtime hot-reload)",
              "arguments": [],
              "name": "dev",
              "subcommands": []
            },
            {
              "about": "Build the selected executable artifact",
              "arguments": [],
              "name": "build",
              "subcommands": []
            },
            {
              "about": "Validate plugin manifest and structure",
              "arguments": [],
              "name": "validate",
              "subcommands": []
            },
            {
              "about": "Prepare plugin for publication (dry-run)",
              "arguments": [],
              "name": "publish",
              "subcommands": []
            },
            {
              "about": "Search the plugin registry",
              "arguments": [],
              "name": "search",
              "subcommands": []
            },
            {
              "about": "Browse plugins in the registry",
              "arguments": [],
              "name": "browse",
              "subcommands": []
            },
            {
              "about": "Update an installed plugin from the registry",
              "arguments": [],
              "name": "update",
              "subcommands": []
            },
            {
              "about": "Explicitly trust native JavaScript execution for this installed artifact",
              "arguments": [],
              "name": "trust",
              "subcommands": []
            },
            {
              "about": "Invoke an installed plugin command or tool through the executable runtime",
              "arguments": [],
              "name": "run",
              "subcommands": []
            }
          ]
        },
        {
          "about": "Debug and diagnostic commands",
          "arguments": [],
          "name": "debug",
          "subcommands": [
            {
              "about": "Check local configuration, storage, and required tools without network access",
              "arguments": [],
              "name": "doctor",
              "subcommands": []
            },
            {
              "about": "Show resolved configuration and config file locations",
              "arguments": [],
              "name": "config",
              "subcommands": []
            },
            {
              "about": "Show file metadata, MIME type, and encoding",
              "arguments": [],
              "name": "file",
              "subcommands": []
            },
            {
              "about": "List and test LSP servers",
              "arguments": [],
              "name": "lsp",
              "subcommands": []
            },
            {
              "about": "Check ripgrep availability and test search",
              "arguments": [],
              "name": "ripgrep",
              "subcommands": []
            },
            {
              "about": "Parse and validate a skill file",
              "arguments": [],
              "name": "skill",
              "subcommands": []
            },
            {
              "about": "Show snapshot status and diffs",
              "arguments": [],
              "name": "snapshot",
              "subcommands": []
            },
            {
              "about": "Show all Cortex paths",
              "arguments": [],
              "name": "paths",
              "subcommands": []
            },
            {
              "about": "Show system information (OS, architecture, shell, etc.) for bug reports",
              "arguments": [],
              "name": "system",
              "subcommands": []
            },
            {
              "about": "Wait for a condition (useful for scripts)",
              "arguments": [],
              "name": "wait",
              "subcommands": []
            }
          ]
        },
        {
          "about": "Start interactive shell/REPL mode",
          "arguments": [],
          "name": "shell",
          "subcommands": []
        },
        {
          "about": "Execute and manage task DAGs (dependency graphs)",
          "arguments": [],
          "name": "dag",
          "subcommands": [
            {
              "about": "Create a new task DAG from a specification file",
              "arguments": [],
              "name": "create",
              "subcommands": []
            },
            {
              "about": "Execute a task DAG",
              "arguments": [],
              "name": "run",
              "subcommands": []
            },
            {
              "about": "Show the status of a DAG",
              "arguments": [],
              "name": "status",
              "subcommands": []
            },
            {
              "about": "List all DAGs",
              "arguments": [],
              "name": "list",
              "subcommands": []
            },
            {
              "about": "Validate a DAG specification",
              "arguments": [],
              "name": "validate",
              "subcommands": []
            },
            {
              "about": "Visualize a DAG structure",
              "arguments": [],
              "name": "graph",
              "subcommands": []
            },
            {
              "about": "Delete a DAG",
              "arguments": [],
              "name": "delete",
              "subcommands": []
            },
            {
              "about": "Resume a partially executed DAG",
              "arguments": [],
              "name": "resume",
              "subcommands": []
            }
          ]
        },
        {
          "about": "Discover Cortex servers on the local network",
          "arguments": [],
          "name": "servers",
          "subcommands": [
            {
              "about": "Re-scan the network for mDNS servers (forces a fresh discovery)",
              "arguments": [],
              "name": "refresh",
              "subcommands": []
            }
          ]
        },
        {
          "about": "View prompt history from past sessions",
          "arguments": [],
          "name": "history",
          "subcommands": [
            {
              "about": "Search history for a pattern",
              "arguments": [],
              "name": "search",
              "subcommands": []
            },
            {
              "about": "Clear history (requires confirmation)",
              "arguments": [],
              "name": "clear",
              "subcommands": []
            }
          ]
        },
        {
          "about": "Manage workspace/project settings",
          "arguments": [],
          "name": "workspace",
          "subcommands": [
            {
              "about": "Show workspace information",
              "arguments": [],
              "name": "show",
              "subcommands": []
            },
            {
              "about": "Initialize workspace configuration",
              "arguments": [],
              "name": "init",
              "subcommands": []
            },
            {
              "about": "Set workspace settings",
              "arguments": [],
              "name": "set",
              "subcommands": []
            },
            {
              "about": "Open workspace configuration in editor",
              "arguments": [],
              "name": "edit",
              "subcommands": []
            }
          ]
        },
        {
          "about": "Run commands within a Cortex-provided sandbox",
          "arguments": [],
          "name": "sandbox",
          "subcommands": [
            {
              "about": "Run a command under Seatbelt (macOS only)",
              "arguments": [],
              "name": "macos",
              "subcommands": []
            },
            {
              "about": "Run a command under Landlock+seccomp (Linux only)",
              "arguments": [],
              "name": "linux",
              "subcommands": []
            },
            {
              "about": "Run a command under Windows restricted token (Windows only)",
              "arguments": [],
              "name": "windows",
              "subcommands": []
            }
          ]
        },
        {
          "about": "Run the HTTP API server (for desktop/web integration)",
          "arguments": [],
          "name": "serve",
          "subcommands": []
        },
        {
          "about": "Print this message or the help of the given subcommand(s)",
          "arguments": [],
          "name": "help",
          "subcommands": []
        }
      ]
    }
  ]
}