create-pmos 0.96.0 → 0.97.0

package/workspace/lib/claude-flags.json

@@ -0,0 +1,992 @@
+{
+  "source": "claude --help",
+  "cli_version": "2.1.293",
+  "flags": [
+    {
+      "flag": "--add-dir",
+      "aliases": [],
+      "value": "required",
+      "arg": "<directories...>",
+      "variadic": true,
+      "choices": null,
+      "suggestions": null,
+      "example": "/path/to/another/folder",
+      "description": "Additional directories to allow tool access to",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--agent",
+      "aliases": [],
+      "value": "required",
+      "arg": "<agent>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": "an agent name",
+      "description": "Agent for the current session. Overrides the 'agent' setting.",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--agents",
+      "aliases": [],
+      "value": "required",
+      "arg": "<json-or-file>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": "{\"reviewer\":{\"description\":\"…\",\"prompt\":\"…\"}}",
+      "description": "JSON object defining custom agents, or with --print the path to a file that holds one (e.g. '{\"reviewer\": {\"description\": \"Reviews code\", \"prompt\": \"You are a code reviewer\"}}')",
+      "printOnly": true,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--allow-dangerously-skip-permissions",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Enable bypassing all permission checks as an option, without it being enabled by default. Recommended only for sandboxes with no internet access.",
+      "printOnly": false,
+      "managed": null,
+      "caution": true
+    },
+    {
+      "flag": "--allowedTools",
+      "aliases": [
+        "--allowed-tools"
+      ],
+      "value": "required",
+      "arg": "<tools...>",
+      "variadic": true,
+      "choices": null,
+      "suggestions": [
+        "Bash(git *)",
+        "Edit",
+        "Read",
+        "Write",
+        "Glob",
+        "Grep",
+        "WebFetch",
+        "WebSearch"
+      ],
+      "example": null,
+      "description": "Comma or space-separated list of tool names to allow (e.g. \"Bash(git *) Edit\")",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--append-system-prompt",
+      "aliases": [],
+      "value": "required",
+      "arg": "<prompt>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": "extra instructions",
+      "description": "Append a system prompt to the default system prompt",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--autocompact",
+      "aliases": [],
+      "value": "required",
+      "arg": "<auto|tokens>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": [
+        "auto",
+        "100k",
+        "200k",
+        "500k",
+        "1M"
+      ],
+      "example": null,
+      "description": "Auto-compact window size (auto, or 100k–1M tokens)",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--ax-screen-reader",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Render screen-reader friendly output (flat text, no decorative borders or animations).",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--bg",
+      "aliases": [
+        "--background"
+      ],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Start the session in the background and return immediately. Prints the id that `claude attach`, `logs`, `stop` and `rm` take; `claude agents` lists them. With --resume <session-id>, continues that session in the background under the same ID, or starts a copy and says so when the session is already running",
+      "printOnly": false,
+      "managed": "detaches the session from the terminal PMOS is showing",
+      "caution": false
+    },
+    {
+      "flag": "--bare",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Minimal mode: skip hooks (those defined in settings and by installed plugins; features built into Claude Code are unaffected), LSP, plugin sync, attribution, auto-memory, background prefetches, keychain reads, and CLAUDE.md auto-discovery. Sets CLAUDE_CODE_SIMPLE=1. Anthropic auth is strictly ANTHROPIC_API_KEY or apiKeyHelper via --settings (OAuth and keychain are never read). 3P providers (Bedrock/Vertex/Foundry) use their own credentials. Skills still resolve via /skill-name. Explicitly provide context via: --system-prompt[-file], --append-system-prompt[-file], --add-dir (CLAUDE.md dirs), --mcp-config, --settings, --agents, --plugin-dir.",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--betas",
+      "aliases": [],
+      "value": "required",
+      "arg": "<betas...>",
+      "variadic": true,
+      "choices": null,
+      "suggestions": null,
+      "example": "a beta header name",
+      "description": "Beta headers to include in API requests (API key users only)",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--brief",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Enable SendUserMessage tool for agent-to-user communication",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--chrome",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Enable Claude in Chrome integration",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--cloud",
+      "aliases": [],
+      "value": "optional",
+      "arg": "[description|session_id|url]",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Create a cloud session with the given description, or attach to an existing one by session ID or claude.ai/code URL",
+      "printOnly": false,
+      "managed": "starts a cloud session, not a terminal session on this machine",
+      "caution": false
+    },
+    {
+      "flag": "--continue",
+      "aliases": [
+        "-c"
+      ],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Continue the most recent conversation in the current directory",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--dangerously-skip-permissions",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Bypass all permission checks. Recommended only for sandboxes with no internet access.",
+      "printOnly": false,
+      "managed": null,
+      "caution": true
+    },
+    {
+      "flag": "--debug",
+      "aliases": [
+        "-d"
+      ],
+      "value": "optional",
+      "arg": "[filter]",
+      "variadic": false,
+      "choices": null,
+      "suggestions": [
+        "api",
+        "hooks",
+        "api,hooks",
+        "!1p,!file"
+      ],
+      "example": null,
+      "description": "Enable debug mode with optional category filtering (e.g., \"api,hooks\" or \"!1p,!file\")",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--debug-file",
+      "aliases": [],
+      "value": "required",
+      "arg": "<path>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": "/tmp/claude-debug.log",
+      "description": "Write debug logs to a specific file path (implicitly enables debug mode)",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--desktop",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Open in the Claude Desktop app instead of the terminal (with --continue or --resume <id> to pick the session)",
+      "printOnly": false,
+      "managed": "opens the Claude Desktop app instead of this terminal",
+      "caution": false
+    },
+    {
+      "flag": "--disable-slash-commands",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Disable all skills",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--disallowedTools",
+      "aliases": [
+        "--disallowed-tools"
+      ],
+      "value": "required",
+      "arg": "<tools...>",
+      "variadic": true,
+      "choices": null,
+      "suggestions": [
+        "Bash",
+        "Edit",
+        "Write",
+        "WebFetch",
+        "WebSearch"
+      ],
+      "example": null,
+      "description": "Comma or space-separated list of tool names to deny (e.g. \"Bash(git *) Edit\")",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--effort",
+      "aliases": [],
+      "value": "required",
+      "arg": "<level>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Effort level for the current session (low, medium, high, xhigh, max)",
+      "printOnly": false,
+      "managed": "the model chips in the form choose the effort",
+      "caution": false
+    },
+    {
+      "flag": "--environment",
+      "aliases": [],
+      "value": "required",
+      "arg": "<environment_id>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Create a new cloud session that runs on the given self-hosted environment (ccpool_...).",
+      "printOnly": false,
+      "managed": "starts a cloud session, not a terminal session on this machine",
+      "caution": false
+    },
+    {
+      "flag": "--exclude-dynamic-system-prompt-sections",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Move per-machine sections (cwd, env info, memory paths, git status) from the system prompt into the first user message. Improves cross-user prompt-cache reuse. Only applies with the default system prompt (ignored with --system-prompt). (default: false)",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--fallback-model",
+      "aliases": [],
+      "value": "required",
+      "arg": "<model>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": [
+        "opus",
+        "sonnet",
+        "haiku"
+      ],
+      "example": null,
+      "description": "Enable automatic fallback to specified model(s) when the default model is overloaded or not available. Accepts a comma-separated list to try each in order. Re-tries the primary at the start of each user turn.",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--file",
+      "aliases": [],
+      "value": "required",
+      "arg": "<specs...>",
+      "variadic": true,
+      "choices": null,
+      "suggestions": null,
+      "example": "file_id:relative_path",
+      "description": "File resources to download at startup. Format: file_id:relative_path (e.g., --file file_abc:doc.txt file_def:img.png)",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--fork-session",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "When resuming, create a new session ID instead of reusing the original (use with --resume or --continue)",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--forward-subagent-text",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Forward subagent text and thinking blocks as assistant/user messages with parent_tool_use_id set (only works with --print and --output-format=stream-json)",
+      "printOnly": true,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--from-pr",
+      "aliases": [],
+      "value": "optional",
+      "arg": "[value]",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": "a PR number or URL",
+      "description": "Resume a session linked to a PR by PR number/URL, or open interactive picker with optional search term",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--ide",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Automatically connect to IDE on startup if exactly one valid IDE is available",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--include-hook-events",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Include all hook lifecycle events in the output stream (only works with --output-format=stream-json)",
+      "printOnly": true,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--include-partial-messages",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Include partial message chunks as they arrive (only works with --print and --output-format=stream-json)",
+      "printOnly": true,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--input-format",
+      "aliases": [],
+      "value": "required",
+      "arg": "<format>",
+      "variadic": false,
+      "choices": [
+        "text",
+        "stream-json"
+      ],
+      "suggestions": null,
+      "example": null,
+      "description": "Input format (only works with --print): \"text\" (default), or \"stream-json\" (realtime streaming input) (choices: \"text\", \"stream-json\")",
+      "printOnly": true,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--json-schema",
+      "aliases": [],
+      "value": "required",
+      "arg": "<schema>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": "{\"type\":\"object\",…}",
+      "description": "JSON Schema for structured output validation. Example: {\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\"}},\"required\":[\"name\"]}",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--max-budget-usd",
+      "aliases": [],
+      "value": "required",
+      "arg": "<amount>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Maximum dollar amount to spend on API calls (only works with --print)",
+      "printOnly": true,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--mcp-config",
+      "aliases": [],
+      "value": "required",
+      "arg": "<configs...>",
+      "variadic": true,
+      "choices": null,
+      "suggestions": null,
+      "example": "/path/to/mcp.json",
+      "description": "Load MCP servers from JSON files or strings (space-separated)",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--model",
+      "aliases": [],
+      "value": "required",
+      "arg": "<model>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Model for the current session. Provide an alias for the latest model (e.g. 'fable', 'opus', or 'sonnet') or a model's full name.",
+      "printOnly": false,
+      "managed": "the model chips in the form choose the model",
+      "caution": false
+    },
+    {
+      "flag": "--name",
+      "aliases": [
+        "-n"
+      ],
+      "value": "required",
+      "arg": "<name>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Set a display name for this session (shown in the prompt box, /resume picker, and terminal title)",
+      "printOnly": false,
+      "managed": "the session name field in the form names the session",
+      "caution": false
+    },
+    {
+      "flag": "--no-chrome",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Disable Claude in Chrome integration",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--no-session-persistence",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Disable session persistence - sessions will not be saved to disk and cannot be resumed (only works with --print)",
+      "printOnly": true,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--output-format",
+      "aliases": [],
+      "value": "required",
+      "arg": "<format>",
+      "variadic": false,
+      "choices": [
+        "text",
+        "json",
+        "stream-json"
+      ],
+      "suggestions": null,
+      "example": null,
+      "description": "Output format (only works with --print): \"text\" (default), \"json\" (single result), or \"stream-json\" (realtime streaming) (choices: \"text\", \"json\", \"stream-json\")",
+      "printOnly": true,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--permission-mode",
+      "aliases": [],
+      "value": "required",
+      "arg": "<mode>",
+      "variadic": false,
+      "choices": [
+        "acceptEdits",
+        "auto",
+        "bypassPermissions",
+        "manual",
+        "dontAsk",
+        "plan"
+      ],
+      "suggestions": null,
+      "example": null,
+      "description": "Permission mode to use for the session (choices: \"acceptEdits\", \"auto\", \"bypassPermissions\", \"manual\", \"dontAsk\", \"plan\")",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--permission-prompts",
+      "aliases": [],
+      "value": "required",
+      "arg": "<target>",
+      "variadic": false,
+      "choices": [
+        "host",
+        "none"
+      ],
+      "suggestions": null,
+      "example": null,
+      "description": "Who answers permission prompts with --print: \"host\" (the SDK host or --permission-prompt-tool) or \"none\" (nobody: anything that would prompt is denied automatically; the permission mode still decides everything else) (choices: \"host\", \"none\", default: \"host\")",
+      "printOnly": true,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--plugin-dir",
+      "aliases": [],
+      "value": "required",
+      "arg": "<path>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": "/path/to/plugin",
+      "description": "Load a plugin from a directory or .zip for this session only; a folder of plugins loads each child (repeatable: --plugin-dir A --plugin-dir B.zip) (default: [])",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--plugin-url",
+      "aliases": [],
+      "value": "required",
+      "arg": "<url>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": "https://example.com/plugin.zip",
+      "description": "Fetch a plugin .zip from a URL for this session only (repeatable: --plugin-url A --plugin-url B) (default: [])",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--print",
+      "aliases": [
+        "-p"
+      ],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Print response and exit (useful for pipes). Note: The workspace trust dialog is skipped when Claude is run in non-interactive mode (via -p, or when stdout is not a TTY, e.g. piped or redirected output). Only use this in directories you trust. Settings files that fail validation are silently ignored in this mode (no error dialog is shown).",
+      "printOnly": true,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--prompt-suggestions",
+      "aliases": [],
+      "value": "optional",
+      "arg": "[value]",
+      "variadic": false,
+      "choices": [
+        "true",
+        "false",
+        "1",
+        "0",
+        "yes",
+        "no",
+        "on",
+        "off"
+      ],
+      "suggestions": null,
+      "example": null,
+      "description": "Enable prompt suggestions. In print/SDK mode, emits a prompt_suggestion message after each turn with a predicted next user prompt (choices: \"true\", \"false\", \"1\", \"0\", \"yes\", \"no\", \"on\", \"off\", preset: \"true\")",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--remote-control",
+      "aliases": [],
+      "value": "optional",
+      "arg": "[name]",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": "a name for the session",
+      "description": "Start an interactive session with Remote Control enabled (optionally named)",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--remote-control-session-name-prefix",
+      "aliases": [],
+      "value": "required",
+      "arg": "<prefix>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": "a prefix, e.g. your hostname",
+      "description": "Prefix for auto-generated Remote Control session names (default: hostname)",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--replay-user-messages",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Re-emit user messages from stdin back on stdout for acknowledgment (only works with --input-format=stream-json and --output-format=stream-json)",
+      "printOnly": true,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--restricted",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Restricted mode: removes the built-in tools that run commands or code (Bash, PowerShell, REPL and the other code-running tools) and WebFetch unless --tools names them, and ignores user, project and local settings files (managed settings and --settings still apply; add --strict-mcp-config to skip MCP servers too). Also confines the file tools to the working directories (--add-dir included), refuses bypassPermissions, and lets only a person or the configured permission handler approve writes to settings, git and tool-configuration files.",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--resume",
+      "aliases": [
+        "-r"
+      ],
+      "value": "optional",
+      "arg": "[value]",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": "a session id, or a search term",
+      "description": "Resume a conversation by session ID, or open interactive picker with optional search term",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--safe-mode",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Start with all customizations (CLAUDE.md, skills, installed plugins, hooks, MCP servers, custom commands and agents, output styles, workflows, custom themes, keybindings, and more) disabled — useful for troubleshooting a broken configuration. Admin-managed (policy) settings still apply. Auth, model selection, built-in tools and plugins, and permissions work normally. Sets CLAUDE_CODE_SAFE_MODE=1.",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--session-id",
+      "aliases": [],
+      "value": "required",
+      "arg": "<uuid>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Use a specific session ID for the conversation (must be a valid UUID)",
+      "printOnly": false,
+      "managed": "PMOS keeps its own session ids",
+      "caution": false
+    },
+    {
+      "flag": "--setting-sources",
+      "aliases": [],
+      "value": "required",
+      "arg": "<sources>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": [
+        "user",
+        "project",
+        "local",
+        "user,project",
+        "user,project,local"
+      ],
+      "example": null,
+      "description": "Comma-separated list of setting sources to load (user, project, local).",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--settings",
+      "aliases": [],
+      "value": "required",
+      "arg": "<file-or-json>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": "/path/to/settings.json",
+      "description": "Path to a settings JSON file or a JSON string to load additional settings from",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--strict-mcp-config",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Only use MCP servers from --mcp-config, ignoring all other MCP configurations",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--system-prompt",
+      "aliases": [],
+      "value": "required",
+      "arg": "<prompt>",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": "instructions that replace the default prompt",
+      "description": "System prompt to use for the session",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--system-prompt-snapshot",
+      "aliases": [],
+      "value": "required",
+      "arg": "<on|off>",
+      "variadic": false,
+      "choices": [
+        "on",
+        "off"
+      ],
+      "suggestions": [
+        "on",
+        "off"
+      ],
+      "example": null,
+      "description": "Record the system prompt once per conversation and reuse it verbatim on every request and resume. on (the default): the prompt is rendered on the conversation's first request — a --system-prompt or --append-system-prompt included — sent, and recorded; every later request and resume sends the record as-is, even when a later launch passes different text, until the conversation is compacted. off: never record; the prompt is rendered fresh every request (for iterating on prompt text). No effect where system-prompt recording is not yet enabled. (choices: \"on\", \"off\")",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--teleport",
+      "aliases": [],
+      "value": "optional",
+      "arg": "[session]",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Resume a teleport session, optionally specify session ID",
+      "printOnly": false,
+      "managed": "starts a cloud session, not a terminal session on this machine",
+      "caution": false
+    },
+    {
+      "flag": "--tmux",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Create a tmux session for the worktree (requires --worktree). Uses iTerm2 native panes when available; use --tmux=classic for traditional tmux.",
+      "printOnly": false,
+      "managed": "only meaningful with --worktree, and PMOS runs every session in its own tmux",
+      "caution": false
+    },
+    {
+      "flag": "--tools",
+      "aliases": [],
+      "value": "required",
+      "arg": "<tools...>",
+      "variadic": true,
+      "choices": null,
+      "suggestions": [
+        "default",
+        "Bash,Edit,Read",
+        "Read,Grep,Glob"
+      ],
+      "example": null,
+      "description": "Specify the list of available tools from the built-in set. Use \"\" to disable all tools, \"default\" to use all tools, or specify tool names (e.g. \"Bash,Edit,Read\").",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--verbose",
+      "aliases": [],
+      "value": "none",
+      "arg": null,
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Override verbose mode setting from config",
+      "printOnly": false,
+      "managed": null,
+      "caution": false
+    },
+    {
+      "flag": "--worktree",
+      "aliases": [
+        "-w"
+      ],
+      "value": "optional",
+      "arg": "[name]",
+      "variadic": false,
+      "choices": null,
+      "suggestions": null,
+      "example": null,
+      "description": "Create a new git worktree for this session (optionally specify a name)",
+      "printOnly": false,
+      "managed": "the branch and “its own folder” choice in the form creates the worktree",
+      "caution": false
+    }
+  ]
+}