Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

681 KB
Raw Blame
{
 "abstract": "Cua: sandboxes, computer actions, MCP, skills and the cua daemon",
 "commands": [
  {
   "abstract": "Log in to Cua and manage the signed-in session",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "auth",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Log in (browser sign-in; `--remote` for a device code), then offer to set up your AI coding agents",
     "after_help": "Examples:\n  # Sign in with the browser\n  cua auth login\n  # Sign in over SSH with a device code\n  cua auth login --remote\n  # Sign in and set up Claude Code without prompts\n  cua auth login --agents claude -y",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not open a browser; print the URL",
       "hidden": false,
       "name": "no-browser",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Sign in from another device with a code (for SSH sessions and computers without a browser)",
       "hidden": false,
       "name": "remote",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Skip the agent onboarding prompt",
       "hidden": false,
       "name": "no-onboarding",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [
        "no-mcp"
       ],
       "default_value": false,
       "env": null,
       "help": "Only install skills",
       "hidden": false,
       "name": "skills-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [
        "no-skills"
       ],
       "default_value": false,
       "env": null,
       "help": "Only configure the MCP server",
       "hidden": false,
       "name": "mcp-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Answer yes to every prompt",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": "y",
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Replace skill folders cua did not write (the old one is backed up)",
       "hidden": false,
       "name": "force",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "login",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": "CUA_AUTH_FLOW",
       "help": "Force a flow: `pkce` or `device`",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "flow",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "FLOW"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Agents: `all` (installed), `none`, or ids such as `claude,codex,hermes` (`cua connect detect` lists every supported agent)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "agents",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "AGENTS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Command agents launch for the MCP server (default: the `cua` on PATH, else this binary)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "mcp-command",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MCP_COMMAND"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua auth login [OPTIONS]"
    },
    {
     "abstract": "Revoke and remove the local session",
     "after_help": "Examples:\n  cua auth logout",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "logout",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua auth logout [OPTIONS]"
    },
    {
     "abstract": "Local session state (no network)",
     "after_help": "Examples:\n  cua auth status\n  cua auth status --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "status",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua auth status [OPTIONS]"
    },
    {
     "abstract": "Who is signed in: the account, its plan and its teams",
     "after_help": "Examples:\n  cua auth whoami\n  cua auth whoami --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "whoami",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua auth whoami [OPTIONS]"
    },
    {
     "abstract": "Whether this cua can read the Cua items in the macOS keychain without a prompt (JSON; for the Spaces app, which asks before it starts anything that reads the session). A Cua-signed cua gives every item it reads the Cua access list, so later Cua builds read it without a prompt",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Let macOS ask for access (its keychain prompt) where needed",
       "hidden": false,
       "name": "prompt",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Remove the stored session without reading it (to sign in again)",
       "hidden": false,
       "name": "forget",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": true,
     "hidden_aliases": [],
     "name": "keychain",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua auth keychain [OPTIONS]"
    },
    {
     "abstract": "Removed: Cua Cloud has ended",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "name": "ARGS",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": true,
     "hidden_aliases": [],
     "name": "keys",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua auth keys [OPTIONS] [ARGS]..."
    },
    {
     "abstract": "Keys of the contrib sandbox providers (`--on e2b`, `--on daytona`, `--on modal`)",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "provider",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [
      {
       "abstract": "Providers, whether this build has them and where their keys come from (never the values)",
       "after_help": "Examples:\n  cua auth provider ls\n  cua auth provider ls --json",
       "aliases": [
        "list"
       ],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "ls",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua auth provider ls [OPTIONS]"
      },
      {
       "abstract": "Store a provider key, read from stdin (no echo on a terminal). An environment variable of the same name wins over the stored key",
       "after_help": "Examples:\n  # Prompt for E2B_API_KEY (no echo)\n  cua auth provider set e2b\n  # One variable only\n  cua auth provider set daytona --var DAYTONA_API_KEY\n  # From a secret manager, without shell history:\n  #   op read op://ci/e2b/key | cua auth provider set e2b",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Provider (`e2b`, `daytona`, `modal`)",
         "hidden": false,
         "is_optional": false,
         "name": "NAME",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "set",
       "options": [
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Only this variable (for example MODAL_TOKEN_SECRET)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "var",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "VAR"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua auth provider set [OPTIONS] <NAME>"
      },
      {
       "abstract": "Remove a provider's stored keys",
       "after_help": "Examples:\n  cua auth provider rm e2b",
       "aliases": [
        "delete"
       ],
       "arguments": [
        {
         "default_value": null,
         "help": "Provider",
         "hidden": false,
         "is_optional": false,
         "name": "NAME",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "rm",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua auth provider rm [OPTIONS] <NAME>"
      }
     ],
     "usage": "cua auth provider [OPTIONS] <COMMAND>"
    }
   ],
   "usage": "cua auth [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Connect the AI agents on this computer to Cua: install the cua skills and configure the cua MCP server",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "connect",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "List supported AI coding agents and which are installed (read-only)",
     "after_help": "Examples:\n  cua connect detect",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "detect",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua connect detect [OPTIONS]"
    },
    {
     "abstract": "Install the default cua skills and configure the cua MCP server",
     "after_help": "Examples:\n  # Every installed agent, asking before each change\n  cua connect setup\n  # Claude Code and Codex, no prompts\n  cua connect setup --agents claude,codex -y\n  # Hermes Agent (Nous Research): ~/.hermes/skills and ~/.hermes/config.yaml\n  cua connect setup --agents hermes -y\n  # Only the MCP server entry\n  cua connect setup --mcp-only\n  # Background computer-use: the cua-driver skill and MCP server\n  cua connect setup --cua-driver --agents all -y\n  # Also copy each agent's sign-in to Keyvault on This Mac (Codex's\n  # ChatGPT sign-in, the sign-in Claude Code already has, Hermes' key)\n  cua connect setup --agents codex,claude --sign-in -y",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [
        "no-mcp"
       ],
       "default_value": false,
       "env": null,
       "help": "Only install skills",
       "hidden": false,
       "name": "skills-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [
        "no-skills"
       ],
       "default_value": false,
       "env": null,
       "help": "Only configure the MCP server",
       "hidden": false,
       "name": "mcp-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Answer yes to every prompt",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": "y",
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Replace skill folders cua did not write (the old one is backed up)",
       "hidden": false,
       "name": "force",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Set up background computer-use instead: the cua-driver skill and the cua-driver MCP server (`cua-driver mcp`). --mcp-command then names the cua-driver binary",
       "hidden": false,
       "name": "cua-driver",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Also make a sign-in for each agent's runs in your Spaces and keep it in Keyvault on This Mac: the sign-in Claude Code already has (read from where Claude Code keeps it, as an access token only; Claude Code's own sign-in is never changed) and Codex's own device sign-in (a link and a code to enter there, in a folder Cua owns); Hermes uses the providers connected in Cua Spaces (Settings, Connections). Only Claude Code's own sign-in is read, and only its access token is kept; Codex's own `auth.json` is never read or changed",
       "hidden": false,
       "name": "sign-in",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Only the sign-in, as `--sign-in`, and nothing else: no Cua skills and no MCP entry are added to any agent, Claude Code is never run to refresh its own sign-in, and nothing is written outside the Cua home (the access token goes to Keyvault, never printed). For a demo, or a home Space that only needs the credential. On a Mac, macOS asks once to let Cua read the Keychain item \"Claude Code-credentials\": that prompt is yours to answer",
       "hidden": false,
       "name": "sign-in-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "setup",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Agents: `all` (installed), `none`, or ids such as `claude,codex,hermes` (`cua connect detect` lists every supported agent)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "agents",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "AGENTS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Command agents launch for the MCP server (default: the `cua` on PATH, else this binary)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "mcp-command",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MCP_COMMAND"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua connect setup [OPTIONS]"
    },
    {
     "abstract": "Whether each agent is really connected: installed and its version, signed in, Cua's MCP entry present and answering, and its sign-in copied to Keyvault. The same rows as the app and the `connect_status` MCP tool",
     "after_help": "Examples:\n  cua connect status\n  cua connect status --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "status",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua connect status [OPTIONS]"
    },
    {
     "abstract": "Remove the Cua Spaces skills and MCP entries cua added (nothing else)",
     "after_help": "Examples:\n  # See what would be removed, change nothing\n  cua connect remove --dry-run\n  cua connect remove\n  cua connect remove --agents codex --skills-only -y\n  # Cua Driver's skill and MCP server too (they stay otherwise)\n  cua connect remove --include-cua-driver\n  # Also delete the sign-in Connect copied to Keyvault\n  cua connect remove --agents codex --sign-in -y",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Only remove skills",
       "hidden": false,
       "name": "skills-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Only remove the MCP entry",
       "hidden": false,
       "name": "mcp-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not ask for confirmation",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": "y",
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Also remove Cua Driver's skill and MCP server (`cua-driver`). Without it only Cua Spaces' own entries go: the `cua` server (`cua-local` for Local) and the Cua Spaces skills",
       "hidden": false,
       "name": "include-cua-driver",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "List exactly what would be removed and change nothing",
       "hidden": false,
       "name": "dry-run",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Also delete the sign-ins Connect copied to Keyvault for these agents",
       "hidden": false,
       "name": "sign-in",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "remove",
     "options": [
      {
       "aliases": [],
       "default_value": "all",
       "env": null,
       "help": "Agents: `all` (default) or ids such as `claude,codex`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "agents",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "AGENTS"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua connect remove [OPTIONS]"
    },
    {
     "abstract": "Refresh installed cua skills and managed MCP entries to this version",
     "after_help": "Examples:\n  cua connect update",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "update",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua connect update [OPTIONS]"
    }
   ],
   "usage": "cua connect [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Deprecated alias of `connect`",
   "aliases": [],
   "arguments": [],
   "deprecated": true,
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "agents",
   "options": [],
   "replaced_by": "cua connect",
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "List supported AI coding agents and which are installed (read-only)",
     "after_help": "Examples:\n  cua connect detect",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "detect",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agents detect [OPTIONS]"
    },
    {
     "abstract": "Install the default cua skills and configure the cua MCP server",
     "after_help": "Examples:\n  # Every installed agent, asking before each change\n  cua connect setup\n  # Claude Code and Codex, no prompts\n  cua connect setup --agents claude,codex -y\n  # Hermes Agent (Nous Research): ~/.hermes/skills and ~/.hermes/config.yaml\n  cua connect setup --agents hermes -y\n  # Only the MCP server entry\n  cua connect setup --mcp-only\n  # Background computer-use: the cua-driver skill and MCP server\n  cua connect setup --cua-driver --agents all -y\n  # Also copy each agent's sign-in to Keyvault on This Mac (Codex's\n  # ChatGPT sign-in, the sign-in Claude Code already has, Hermes' key)\n  cua connect setup --agents codex,claude --sign-in -y",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [
        "no-mcp"
       ],
       "default_value": false,
       "env": null,
       "help": "Only install skills",
       "hidden": false,
       "name": "skills-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [
        "no-skills"
       ],
       "default_value": false,
       "env": null,
       "help": "Only configure the MCP server",
       "hidden": false,
       "name": "mcp-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Answer yes to every prompt",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": "y",
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Replace skill folders cua did not write (the old one is backed up)",
       "hidden": false,
       "name": "force",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Set up background computer-use instead: the cua-driver skill and the cua-driver MCP server (`cua-driver mcp`). --mcp-command then names the cua-driver binary",
       "hidden": false,
       "name": "cua-driver",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Also make a sign-in for each agent's runs in your Spaces and keep it in Keyvault on This Mac: the sign-in Claude Code already has (read from where Claude Code keeps it, as an access token only; Claude Code's own sign-in is never changed) and Codex's own device sign-in (a link and a code to enter there, in a folder Cua owns); Hermes uses the providers connected in Cua Spaces (Settings, Connections). Only Claude Code's own sign-in is read, and only its access token is kept; Codex's own `auth.json` is never read or changed",
       "hidden": false,
       "name": "sign-in",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Only the sign-in, as `--sign-in`, and nothing else: no Cua skills and no MCP entry are added to any agent, Claude Code is never run to refresh its own sign-in, and nothing is written outside the Cua home (the access token goes to Keyvault, never printed). For a demo, or a home Space that only needs the credential. On a Mac, macOS asks once to let Cua read the Keychain item \"Claude Code-credentials\": that prompt is yours to answer",
       "hidden": false,
       "name": "sign-in-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "setup",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Agents: `all` (installed), `none`, or ids such as `claude,codex,hermes` (`cua connect detect` lists every supported agent)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "agents",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "AGENTS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Command agents launch for the MCP server (default: the `cua` on PATH, else this binary)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "mcp-command",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MCP_COMMAND"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agents setup [OPTIONS]"
    },
    {
     "abstract": "Whether each agent is really connected: installed and its version, signed in, Cua's MCP entry present and answering, and its sign-in copied to Keyvault. The same rows as the app and the `connect_status` MCP tool",
     "after_help": "Examples:\n  cua connect status\n  cua connect status --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "status",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agents status [OPTIONS]"
    },
    {
     "abstract": "Remove the Cua Spaces skills and MCP entries cua added (nothing else)",
     "after_help": "Examples:\n  # See what would be removed, change nothing\n  cua connect remove --dry-run\n  cua connect remove\n  cua connect remove --agents codex --skills-only -y\n  # Cua Driver's skill and MCP server too (they stay otherwise)\n  cua connect remove --include-cua-driver\n  # Also delete the sign-in Connect copied to Keyvault\n  cua connect remove --agents codex --sign-in -y",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Only remove skills",
       "hidden": false,
       "name": "skills-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Only remove the MCP entry",
       "hidden": false,
       "name": "mcp-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not ask for confirmation",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": "y",
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Also remove Cua Driver's skill and MCP server (`cua-driver`). Without it only Cua Spaces' own entries go: the `cua` server (`cua-local` for Local) and the Cua Spaces skills",
       "hidden": false,
       "name": "include-cua-driver",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "List exactly what would be removed and change nothing",
       "hidden": false,
       "name": "dry-run",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Also delete the sign-ins Connect copied to Keyvault for these agents",
       "hidden": false,
       "name": "sign-in",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "remove",
     "options": [
      {
       "aliases": [],
       "default_value": "all",
       "env": null,
       "help": "Agents: `all` (default) or ids such as `claude,codex`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "agents",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "AGENTS"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agents remove [OPTIONS]"
    },
    {
     "abstract": "Refresh installed cua skills and managed MCP entries to this version",
     "after_help": "Examples:\n  cua connect update",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "update",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agents update [OPTIONS]"
    }
   ],
   "usage": "cua agents [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Share a link to a port, a file or a folder that opens on your other signed-in devices (never localhost): `cua share 3000`, `cua share ./report.html`, `cua share ls`, `cua share stop ID`",
   "after_help": "Examples:\n  # A dev server on this machine, for your own devices (phone included)\n  cua share 3000\n  # A port inside a Space\n  cua share space:dev:3000\n  # A report or a folder, read-only\n  cua share ./report.html\n  cua share ./build/\n  # Members of your team\n  cua share 3000 --team\n  # Anyone with the link, for an hour\n  cua share ./report.html --public --ttl 1h\n  # A game server in a Space, at a public address (Labs: Public TCP shares)\n  cua share space:mc:25565 --tcp --public --service minecraft\n  # The same from an agent inside the Space (its own port)\n  cua share 25565 --tcp --public --service minecraft\n  # Through your own cloud only, for two friends' addresses\n  cua share space:mc:25565 --tcp --public --route edge --allow 203.0.113.7 --allow 198.51.100.0/24\n  # A share an agent asked for, waiting for you\n  cua share approve share-1a2b3c4d5e6f\n  # Where public TCP shares go, the daily data cap and the default allowlist\n  cua share settings\n  # What is shared, and stop it\n  cua share ls\n  cua share stop share-1a2b3c4d5e6f\n  cua share stop all",
   "aliases": [],
   "arguments": [
    {
     "default_value": null,
     "help": "What to share: a port (`3000`), a port in a Space (`space:NAME:3000`), or a file or folder (`./report.html`, `./build/`). Paths are read-only; use `./ls` for a file called `ls`",
     "hidden": false,
     "is_optional": false,
     "name": "TARGET",
     "possible_values": [],
     "repeatable": false,
     "type": "string"
    }
   ],
   "flags": [
    {
     "aliases": [],
     "default_value": false,
     "env": null,
     "help": "Share with the members of your team",
     "hidden": false,
     "name": "team",
     "repeatable": false,
     "short_name": null,
     "takes_value": false
    },
    {
     "aliases": [],
     "default_value": false,
     "env": null,
     "help": "Anyone with the link can open it. Expires (default 1h, 60s to 24h)",
     "hidden": false,
     "name": "public",
     "repeatable": false,
     "short_name": null,
     "takes_value": false
    },
    {
     "aliases": [],
     "default_value": false,
     "env": null,
     "help": "Share a raw TCP service in a Space (a game server, for example) at a public address instead of a link: anyone with the address can connect, for 24h unless --ttl says less. Needs --public and a port in a Space (inside a Space, a bare port is its own). An experiment: turn on Public TCP shares in Settings, Labs",
     "hidden": false,
     "name": "tcp",
     "repeatable": false,
     "short_name": null,
     "takes_value": false
    },
    {
     "aliases": [],
     "default_value": false,
     "env": null,
     "help": "With --tcp --service minecraft: drop connections that did not dial this share's address (scanners, stale addresses)",
     "hidden": false,
     "name": "check-host",
     "repeatable": false,
     "short_name": null,
     "takes_value": false
    },
    {
     "aliases": [],
     "default_value": false,
     "env": null,
     "help": "With --tcp: agree to the share edge's cost without asking (the first share through your cloud creates a small server there)",
     "hidden": false,
     "name": "yes",
     "repeatable": false,
     "short_name": "y",
     "takes_value": false
    }
   ],
   "hidden": false,
   "hidden_aliases": [],
   "name": "share",
   "options": [
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "How long the share lasts (`10m`, `1h`, 60s to 24h). Public shares default to 1h; the others have no end unless you set one",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "ttl",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "DURATION"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "A name for `cua share ls` (and `cua share stop NAME`)",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "name",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "NAME"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "With --tcp: the game or service (`minecraft`), for a name people can type instead of the address",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "service",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "SERVICE"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "With --tcp: how people reach it. `auto` (default) takes the Space's own host in your cloud, else a small server in your linked cloud (a share edge), else Cua's relay, within `cua share settings`",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "route",
     "possible_values": [
      "auto",
      "host",
      "edge",
      "relay"
     ],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "auto | host | edge | relay",
     "value_name": "ROUTE"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "With --tcp: only these addresses or CIDRs may connect (repeat it). Default: the settings' allowlist, usually anyone",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "allow",
     "possible_values": [],
     "repeatable": true,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "CIDR"
    }
   ],
   "subcommand_optional": true,
   "subcommands": [
    {
     "abstract": "List the active shares",
     "after_help": "Examples:\n  # What is shared right now\n  cua share ls\n  # The same as JSON\n  cua share ls --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "ls",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua share ls [OPTIONS]"
    },
    {
     "abstract": "Stop a share (its link stops working at once), or `all`",
     "after_help": "Examples:\n  # Stop one share by its id\n  cua share stop share-1a2b3c4d5e6f\n  # Stop everything this machine shares\n  cua share stop all",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The share's id or name from `cua share ls`, or `all`",
       "hidden": false,
       "is_optional": false,
       "name": "ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "stop",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua share stop [OPTIONS] <ID>"
    },
    {
     "abstract": "Open a share's link once, as its owner, and say what came back",
     "after_help": "Examples:\n  # Does the link load?\n  cua share check share-1a2b3c4d5e6f\n  # Open a page below the link\n  cua share check share-1a2b3c4d5e6f /index.html",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The share's id or name",
       "hidden": false,
       "is_optional": false,
       "name": "ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "A path below the link to open",
       "hidden": false,
       "is_optional": true,
       "name": "PATH",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "check",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua share check [OPTIONS] <ID> [PATH]"
    },
    {
     "abstract": "Let a waiting public TCP share go live: one an agent in a Space asked for, or the first through a share edge in your cloud",
     "after_help": "Examples:\n  # See what waits, then approve it\n  cua share ls\n  cua share approve share-1a2b3c4d5e6f\n  # And let that Space share without asking from now on\n  cua share approve share-1a2b3c4d5e6f --always",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The waiting share's id",
       "hidden": false,
       "is_optional": false,
       "name": "ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Let its Space's agents share without asking from now on",
       "hidden": false,
       "name": "always",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "approve",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua share approve [OPTIONS] <ID>"
    },
    {
     "abstract": "Turn down a waiting public TCP share",
     "after_help": "Examples:\n  cua share deny share-1a2b3c4d5e6f",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The waiting share's id",
       "hidden": false,
       "is_optional": false,
       "name": "ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "deny",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua share deny [OPTIONS] <ID>"
    },
    {
     "abstract": "Where public TCP shares go, the daily data cap, the default allowlist and the approval rule; with no flags, shows them",
     "after_help": "Examples:\n  # Show them\n  cua share settings\n  # Never through Cua: only your own cloud\n  cua share settings --land only-my-cloud\n  # A 5 GB daily data cap, or none\n  cua share settings --daily-cap 5GB\n  cua share settings --daily-cap off\n  # New shares only for these addresses\n  cua share settings --allow 203.0.113.0/24\n  # Remove the share edge from your cloud now\n  cua share settings --remove-edge",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "New shares are open to anyone (clears the allowlist)",
       "hidden": false,
       "name": "allow-anyone",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Remove the share edge from your cloud now; its shares end",
       "hidden": false,
       "name": "remove-edge",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "settings",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "`auto`, `only-my-cloud` or `allow-relay`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "land",
       "possible_values": [
        "auto",
        "only-my-cloud",
        "allow-relay"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "auto | only-my-cloud | allow-relay",
       "value_name": "LAND"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Whether Cua's relay may carry public TCP shares at all",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "relay",
       "possible_values": [
        "on",
        "off"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "on | off",
       "value_name": "RELAY"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The most data public TCP shares move in a day (`2GB`, `500MB`, `off`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "daily-cap",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SIZE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The allowlist new shares start with (repeat it)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "allow",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "CIDR"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Ask before an agent's share goes public (`on`, the default)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "approve-agents",
       "possible_values": [
        "on",
        "off"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "on | off",
       "value_name": "APPROVE_AGENTS"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua share settings [OPTIONS]"
    }
   ],
   "usage": "cua share [OPTIONS] <TARGET>\n       cua share <COMMAND>"
  },
  {
   "abstract": "Agents in a Space: add, send, ls, rm, schedule; run, logs, stop",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "agent",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Add an agent: a name, a harness and a Space",
     "after_help": "Examples:\n  cua agent add ada --harness hermes --in local:dev --env-from-host OPENAI_API_KEY\n  cua agent add ada --harness claude-code --in local:dev \"summarize the repo\"\n  cua agent add ada --harness claude-code --in local:dev --daily 08:00 \"plan the day\"\n  cua agent add fix-1 --harness claude-code --in local:dev --once \"fix the failing test\"\n  cua agent add nightly --harness claude-code --durable --on auto \"refactor the parser\"",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The agent's name: 1-63 of a-z, 0-9, `.`, `_`, `-`",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "What it starts on: a first message, a scheduled task (with --daily/--every/--weekly) or the task (--once, --durable)",
       "hidden": false,
       "is_optional": true,
       "name": "PROMPT",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "discussion": ".\n\nWith PROMPT it starts at once. --daily, --every or --weekly schedule PROMPT instead; --once runs PROMPT as a one-off task; --durable keeps it running through crashes.",
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "A one-off task: run PROMPT and stop when it is answered (no name kept, no memory)",
       "hidden": false,
       "name": "once",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Keep it running through crashes: your machines' coordinator starts it again (a durable session, `cua agent run --durable`)",
       "hidden": false,
       "name": "durable",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "add",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Harness id (`cua agent harnesses`)",
       "hidden": false,
       "is_optional": false,
       "multiple_values": false,
       "name": "harness",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "HARNESS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The Space it works in (with --durable: a durable Space by name; default `auto`, none)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "in",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SPACE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "model",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MODEL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "base-url",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "BASE_URL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Provider key variable to forward at each start. Repeatable",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "env-from-host",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "VAR"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --durable: the machine the driver runs on (`auto`, or a machine's name; default: this machine)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "on",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MACHINE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --durable: drives allowed in total before the session fails (default 5)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-attempts",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "N"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --durable: seconds the driver may write no output before it counts as wedged, is cancelled and started again (default 120; 0: never). Drivers print a heartbeat every quarter of it",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "stall-secs",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "SECS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Schedule PROMPT every N minutes",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "every",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MINUTES"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Schedule PROMPT every day at HH:MM",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "daily",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "HH:MM"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Schedule PROMPT every week, `mon 09:00`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "weekly",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "DAY HH:MM"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The schedule's title (default: the agent's name)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "title",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TITLE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent add [OPTIONS] --harness <HARNESS> <NAME> [PROMPT]"
    },
    {
     "abstract": "Start a coding agent in a sandbox (returns at once unless --follow)",
     "after_help": "Examples:\n  cua agent run local:dev claude-code \"fix the failing test\" --env-from-host ANTHROPIC_API_KEY -f\n  cua agent run local:ci openai-codex \"add tests\" --repo https://github.com/org/repo --exit-when-idle",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox (`local:NAME`, `direct:HOST:PORT`, or NAME)",
       "hidden": false,
       "is_optional": false,
       "name": "SANDBOX",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Harness (`cua agent harnesses`)",
       "hidden": false,
       "is_optional": false,
       "name": "HARNESS",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "The task",
       "hidden": false,
       "is_optional": false,
       "name": "PROMPT",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not give the agent the sandbox's own MCP tools",
       "hidden": false,
       "name": "no-sandbox-mcp",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not copy the cua skills into the harness",
       "hidden": false,
       "name": "no-skills",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Stop (resumably) once the prompt is answered",
       "hidden": false,
       "name": "exit-when-idle",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Stream events until the turn ends",
       "hidden": false,
       "name": "follow",
       "repeatable": false,
       "short_name": "f",
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Keep the agent alive across a lost driver or machine: your machines' coordinator starts it again (a higher epoch each time, with backoff and a cap). SANDBOX is then a durable Space by name, or `auto` for none",
       "hidden": false,
       "name": "durable",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "run",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Forward a provider key from this shell's environment (repeatable), for example ANTHROPIC_API_KEY. The value never appears in argv",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "env-from-host",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "VAR"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Git repository cloned into the working directory first",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "repo",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REPO"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "branch",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "BRANCH"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Working directory in the sandbox",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cwd",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "CWD"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "model",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MODEL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A custom model endpoint (proxy or compatible server)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "base-url",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "BASE_URL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Its wire format: anthropic, openai-responses, openai-chat, gemini",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "wire",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "WIRE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "An MCP server for the agent: NAME=URL (HTTP, as reachable inside the sandbox) or NAME=cmd:COMMAND ARGS... (stdio, run in the sandbox)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "mcp",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME=URL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Attach a local file to the prompt (repeatable)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "file",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "path",
       "value_name": "PATH"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "label",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "LABEL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --durable: the machine the driver runs on (`auto`, or a machine's name; default: this machine)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "on",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MACHINE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --durable: drives allowed in total before the session fails (default 5)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-attempts",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "N"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --durable: seconds the driver may write no output before it counts as wedged, is cancelled and started again (default 120; 0: never). Drivers print a heartbeat every quarter of it",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "stall-secs",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "SECS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --durable: the session's name (default: generated)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "name",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "driver-cmd",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "DRIVER_CMD"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "driver-bundle",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "path",
       "value_name": "DRIVER_BUNDLE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent run [OPTIONS] <SANDBOX> <HARNESS> <PROMPT>"
    },
    {
     "abstract": "List your agents, or with SANDBOX the runs in it",
     "after_help": "Examples:\n  cua agent ls\n  cua agent ls local:dev",
     "aliases": [
      "list"
     ],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox (`local:NAME`, `direct:HOST:PORT`, or NAME). Without it: your named agents",
       "hidden": false,
       "is_optional": true,
       "name": "SANDBOX",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "ls",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent ls [OPTIONS] [SANDBOX]"
    },
    {
     "abstract": "Print a run's normalized events (--follow to stream)",
     "after_help": "Examples:\n  cua agent logs local:dev run-1a2b3c4d -f\n  cua agent logs session:refactor -f",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox, or `session:NAME` for a durable session",
       "hidden": false,
       "is_optional": false,
       "name": "SANDBOX",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "The run (not for a session)",
       "hidden": false,
       "is_optional": true,
       "name": "RUN_ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Keep streaming until the turn ends",
       "hidden": false,
       "name": "follow",
       "repeatable": false,
       "short_name": "f",
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Print each event's JSON (raw ACP payload included)",
       "hidden": false,
       "name": "raw",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "logs",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent logs [OPTIONS] <SANDBOX> [RUN_ID]"
    },
    {
     "abstract": "Message a named agent (`send NAME TEXT`), or send a follow-up to a run (`send SANDBOX RUN_ID TEXT`, queued while a turn runs)",
     "after_help": "Examples:\n  cua agent send ada \"what did you learn yesterday?\"\n  cua agent send local:dev run-1a2b3c4d \"now add a regression test\" -f",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "A named agent, or the sandbox of a run",
       "hidden": false,
       "is_optional": false,
       "name": "NAME|SANDBOX",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "The message for a named agent, or the run",
       "hidden": false,
       "is_optional": false,
       "name": "TEXT|RUN_ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "The message for a run",
       "hidden": false,
       "is_optional": true,
       "name": "TEXT",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Follow a run's turn (`send SANDBOX RUN_ID TEXT` only)",
       "hidden": false,
       "name": "follow",
       "repeatable": false,
       "short_name": "f",
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "send",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent send [OPTIONS] <NAME|SANDBOX> <TEXT|RUN_ID> [TEXT]"
    },
    {
     "abstract": "Cancel the turn in flight (the session stays open)",
     "after_help": "Examples:\n  cua agent interrupt local:dev run-1a2b3c4d",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "SANDBOX",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "RUN_ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "interrupt",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent interrupt [OPTIONS] <SANDBOX> <RUN_ID>"
    },
    {
     "abstract": "Stop a run and verify it is gone",
     "after_help": "Examples:\n  cua agent stop local:dev run-1a2b3c4d\n  cua agent stop session:refactor",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox, or `session:NAME` for a durable session",
       "hidden": false,
       "is_optional": false,
       "name": "SANDBOX",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "The run (not for a session)",
       "hidden": false,
       "is_optional": true,
       "name": "RUN_ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "stop",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent stop [OPTIONS] <SANDBOX> [RUN_ID]"
    },
    {
     "abstract": "A run's status and last result",
     "after_help": "Examples:\n  cua agent status local:dev run-1a2b3c4d\n  cua agent status session:refactor",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox, or `session:NAME` for a durable session",
       "hidden": false,
       "is_optional": false,
       "name": "SANDBOX",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "The run (not for a session)",
       "hidden": false,
       "is_optional": true,
       "name": "RUN_ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "status",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent status [OPTIONS] <SANDBOX> [RUN_ID]"
    },
    {
     "abstract": "Remove a named agent (its home stays in the Cua Volume), or stop a run and delete its record (secrets included)",
     "after_help": "Examples:\n  cua agent rm ada\n  cua agent rm local:dev run-1a2b3c4d\n  cua agent rm session:refactor",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "A named agent, a sandbox, or `session:NAME` for a durable session",
       "hidden": false,
       "is_optional": false,
       "name": "NAME|SANDBOX",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "The run (not for a session)",
       "hidden": false,
       "is_optional": true,
       "name": "RUN_ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "rm",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent rm [OPTIONS] <NAME|SANDBOX> [RUN_ID]"
    },
    {
     "abstract": "Install harnesses or apps now (`claude-code`, `blender`, ...)",
     "after_help": "Examples:\n  cua agent ensure local:dev claude-code vscode",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "SANDBOX",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "IDS",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "ensure",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent ensure [OPTIONS] <SANDBOX> <IDS>..."
    },
    {
     "abstract": "A named agent's schedules: turns the daemon starts with or without the app open",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "schedule",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [
      {
       "abstract": "Add a schedule (give one of --every, --daily, --weekly)",
       "after_help": "Examples:\n  cua agent schedule add ada --title \"Inbox sweep\" --prompt \"Triage new issues\" --every 60\n  cua agent schedule add ada --title \"Morning\" --prompt \"Plan the day\" --daily 08:00",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "",
         "hidden": false,
         "is_optional": false,
         "name": "AGENT",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "add",
       "options": [
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "",
         "hidden": false,
         "is_optional": false,
         "multiple_values": false,
         "name": "title",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "TITLE"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "",
         "hidden": false,
         "is_optional": false,
         "multiple_values": false,
         "name": "prompt",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "PROMPT"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Every N minutes",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "every",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "integer",
         "value_name": "MINUTES"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Every day at HH:MM",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "daily",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "HH:MM"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Every week, `mon 09:00`",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "weekly",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "DAY HH:MM"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua agent schedule add [OPTIONS] --title <TITLE> --prompt <PROMPT> <AGENT>"
      },
      {
       "abstract": "List schedules",
       "after_help": "Examples:\n  cua agent schedule ls\n  cua agent schedule ls ada",
       "aliases": [
        "list"
       ],
       "arguments": [
        {
         "default_value": null,
         "help": "",
         "hidden": false,
         "is_optional": true,
         "name": "AGENT",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "ls",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua agent schedule ls [OPTIONS] [AGENT]"
      },
      {
       "abstract": "Delete a schedule",
       "after_help": "Examples:\n  cua agent schedule rm 0F3A2C1E-8B7D-4E6F-9A1B-2C3D4E5F6A7B",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "",
         "hidden": false,
         "is_optional": false,
         "name": "ID",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "rm",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua agent schedule rm [OPTIONS] <ID>"
      },
      {
       "abstract": "Turn a schedule on",
       "after_help": "Examples:\n  cua agent schedule enable 0F3A2C1E-8B7D-4E6F-9A1B-2C3D4E5F6A7B",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "",
         "hidden": false,
         "is_optional": false,
         "name": "ID",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "enable",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua agent schedule enable [OPTIONS] <ID>"
      },
      {
       "abstract": "Turn a schedule off",
       "after_help": "Examples:\n  cua agent schedule disable 0F3A2C1E-8B7D-4E6F-9A1B-2C3D4E5F6A7B",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "",
         "hidden": false,
         "is_optional": false,
         "name": "ID",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "disable",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua agent schedule disable [OPTIONS] <ID>"
      }
     ],
     "usage": "cua agent schedule [OPTIONS] <COMMAND>"
    },
    {
     "abstract": "Durable sessions: agents your machines keep alive (`run --durable`)",
     "after_help": "Examples:\n  cua agent sessions\n  cua --json agent sessions",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "sessions",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent sessions [OPTIONS]"
    },
    {
     "abstract": "The harnesses: readiness, installs, key variables, limits",
     "after_help": "Examples:\n  cua agent harnesses\n  cua --json agent harnesses",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "harnesses",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent harnesses [OPTIONS]"
    },
    {
     "abstract": "The provider keys agents get, kept in the Keychain by the Cua daemon (Cua Spaces → Settings → Connections). Values are read from stdin and never printed",
     "after_help": "Examples:\n  cua agent keys\n  cua agent keys set anthropic\n  cua agent keys rm OPENAI_API_KEY",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "keys",
     "options": [],
     "subcommand_optional": true,
     "subcommands": [
      {
       "abstract": "List the saved keys (never their values)",
       "after_help": "Examples:\n  cua agent keys ls\n  cua --json agent keys ls",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "ls",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua agent keys ls [OPTIONS]"
      },
      {
       "abstract": "Add or replace a key, read from stdin. PROVIDER: anthropic, openai or other (with --env). Pipe the key in (`pbpaste | cua agent keys set anthropic`); a terminal is refused so the key isn't echoed",
       "after_help": "Examples:\n  cua agent keys set anthropic\n  cua agent keys set other --env GEMINI_API_KEY",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "",
         "hidden": false,
         "is_optional": false,
         "name": "PROVIDER",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "set",
       "options": [
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "The variable an Other key is given to runs as",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "env",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "ENV"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua agent keys set [OPTIONS] <PROVIDER>"
      },
      {
       "abstract": "Ask each provider whether the saved API keys still work (a cheap read-only request; nothing is sent that is not a key's own request). A key the provider refuses is listed as needing a reconnect, and runs are not given it until it is saved again",
       "after_help": "Examples:\n  cua agent keys check",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "check",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua agent keys check [OPTIONS]"
      },
      {
       "abstract": "Remove the key a run gets as ENV",
       "after_help": "Examples:\n  cua agent keys rm ANTHROPIC_API_KEY",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "",
         "hidden": false,
         "is_optional": false,
         "name": "ENV",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "rm",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua agent keys rm [OPTIONS] <ENV>"
      }
     ],
     "usage": "cua agent keys [OPTIONS] [COMMAND]"
    },
    {
     "abstract": "Deprecated alias of `add`. Creates a named agent whose memory lives in the Cua Volume (agents/NAME/) and outlives its Space",
     "after_help": "Examples:\n  cua agent create ada --harness hermes --in local:dev --env-from-host OPENAI_API_KEY\n  cua agent create scout --harness claude-code --in local:scout --env-from-host ANTHROPIC_API_KEY",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "deprecated": true,
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "create",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Harness id (`cua agent harnesses`)",
       "hidden": false,
       "is_optional": false,
       "multiple_values": false,
       "name": "harness",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "HARNESS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The Space it works in",
       "hidden": false,
       "is_optional": false,
       "multiple_values": false,
       "name": "in",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SPACE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "model",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MODEL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "base-url",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "BASE_URL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Provider key variable to forward at each start. Repeatable",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "env-from-host",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ENV_FROM_HOST"
      }
     ],
     "replaced_by": "cua agent add",
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent create [OPTIONS] --harness <HARNESS> --in <SPACE> <NAME>"
    },
    {
     "abstract": "Deprecated alias of `ls` (without a sandbox). Lists named agents",
     "after_help": "Examples:\n  cua agent persistent",
     "aliases": [],
     "arguments": [],
     "deprecated": true,
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "persistent",
     "options": [],
     "replaced_by": "cua agent ls",
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent persistent [OPTIONS]"
    },
    {
     "abstract": "Deprecated alias of `send NAME TEXT`. Gives a named agent a turn (starts a run with its home restored, or follows up on its idle run)",
     "after_help": "Examples:\n  cua agent tell ada \"what did you learn yesterday?\"",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "TEXT",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "deprecated": true,
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "tell",
     "options": [],
     "replaced_by": "cua agent send",
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent tell [OPTIONS] <NAME> <TEXT>"
    },
    {
     "abstract": "Save a persistent agent's home into the drive now",
     "after_help": "Examples:\n  cua agent save ada",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "save",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent save [OPTIONS] <NAME>"
    },
    {
     "abstract": "Pause a persistent agent: its run, its routines, and its Space (suspended when local; a cloud Space is released after the home is saved)",
     "after_help": "Examples:\n  cua agent pause ada",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "pause",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent pause [OPTIONS] <NAME>"
    },
    {
     "abstract": "Resume a paused persistent agent",
     "after_help": "Examples:\n  cua agent resume ada\n  cua agent resume ada --prompt \"pick up where you left off\"",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "resume",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "prompt",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PROMPT"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent resume [OPTIONS] <NAME>"
    },
    {
     "abstract": "Deprecated alias of `rm NAME`. Forgets a named agent (its home stays in the Cua Volume)",
     "after_help": "Examples:\n  cua agent forget ada",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "deprecated": true,
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "forget",
     "options": [],
     "replaced_by": "cua agent rm",
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent forget [OPTIONS] <NAME>"
    },
    {
     "abstract": "Deprecated alias of `schedule`. A named agent's schedules",
     "aliases": [],
     "arguments": [],
     "deprecated": true,
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "routine",
     "options": [],
     "replaced_by": "cua agent schedule",
     "subcommand_optional": false,
     "subcommands": [
      {
       "abstract": "Add a schedule (give one of --every, --daily, --weekly)",
       "after_help": "Examples:\n  cua agent schedule add ada --title \"Inbox sweep\" --prompt \"Triage new issues\" --every 60\n  cua agent schedule add ada --title \"Morning\" --prompt \"Plan the day\" --daily 08:00",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "",
         "hidden": false,
         "is_optional": false,
         "name": "AGENT",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "add",
       "options": [
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "",
         "hidden": false,
         "is_optional": false,
         "multiple_values": false,
         "name": "title",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "TITLE"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "",
         "hidden": false,
         "is_optional": false,
         "multiple_values": false,
         "name": "prompt",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "PROMPT"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Every N minutes",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "every",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "integer",
         "value_name": "MINUTES"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Every day at HH:MM",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "daily",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "HH:MM"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Every week, `mon 09:00`",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "weekly",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "DAY HH:MM"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua agent routine add [OPTIONS] --title <TITLE> --prompt <PROMPT> <AGENT>"
      },
      {
       "abstract": "List schedules",
       "after_help": "Examples:\n  cua agent schedule ls\n  cua agent schedule ls ada",
       "aliases": [
        "list"
       ],
       "arguments": [
        {
         "default_value": null,
         "help": "",
         "hidden": false,
         "is_optional": true,
         "name": "AGENT",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "ls",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua agent routine ls [OPTIONS] [AGENT]"
      },
      {
       "abstract": "Delete a schedule",
       "after_help": "Examples:\n  cua agent schedule rm 0F3A2C1E-8B7D-4E6F-9A1B-2C3D4E5F6A7B",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "",
         "hidden": false,
         "is_optional": false,
         "name": "ID",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "rm",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua agent routine rm [OPTIONS] <ID>"
      },
      {
       "abstract": "Turn a schedule on",
       "after_help": "Examples:\n  cua agent schedule enable 0F3A2C1E-8B7D-4E6F-9A1B-2C3D4E5F6A7B",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "",
         "hidden": false,
         "is_optional": false,
         "name": "ID",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "enable",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua agent routine enable [OPTIONS] <ID>"
      },
      {
       "abstract": "Turn a schedule off",
       "after_help": "Examples:\n  cua agent schedule disable 0F3A2C1E-8B7D-4E6F-9A1B-2C3D4E5F6A7B",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "",
         "hidden": false,
         "is_optional": false,
         "name": "ID",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "disable",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua agent routine disable [OPTIONS] <ID>"
      }
     ],
     "usage": "cua agent routine [OPTIONS] <COMMAND>"
    },
    {
     "abstract": "Let a persistent agent use one of your computers (asks for presence)",
     "after_help": "Examples:\n  cua agent allow-computer ada relay:0123456789abcdef",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "The computer's Space id (`cua host status` shows this computer's)",
       "hidden": false,
       "is_optional": false,
       "name": "COMPUTER",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "allow-computer",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "End the grant after this many seconds",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "for",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "SECS"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent allow-computer [OPTIONS] <NAME> <COMPUTER>"
    },
    {
     "abstract": "Take a persistent agent's computer access back",
     "after_help": "Examples:\n  cua agent revoke-computer ada\n  cua agent revoke-computer ada relay:0123456789abcdef",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "name": "COMPUTER",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "revoke-computer",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent revoke-computer [OPTIONS] <NAME> [COMPUTER]"
    },
    {
     "abstract": "Which agents may use which computers, and the audit log",
     "after_help": "Examples:\n  cua agent computer-access --audit 20",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "computer-access",
     "options": [
      {
       "aliases": [],
       "default_value": "0",
       "env": null,
       "help": "Also print this many audit entries",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "audit",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "AUDIT"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent computer-access [OPTIONS] [NAME]"
    },
    {
     "abstract": "The notifications the Cua app shows (turn ends, notify_user, requests)",
     "after_help": "Examples:\n  cua agent notifications --unread\n  cua agent notifications --mark-read",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "",
       "hidden": false,
       "name": "unread",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Mark every notification read",
       "hidden": false,
       "name": "mark-read",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "notifications",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua agent notifications [OPTIONS]"
    }
   ],
   "usage": "cua agent [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Sandboxes: local or an existing computer (direct)",
   "aliases": [
    "sb"
   ],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "sandbox",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Create a sandbox: `cua sb create IMAGE [--on local|direct:<addr>] [--kind auto|container|vm|microvm] [--runtime auto|gvisor|runc|qemu|lume|firecracker|vz|containerization]`",
     "after_help": "Examples:\n  # A Linux desktop on this computer (a gVisor container)\n  cua sb create linux --name dev\n  # A web server container, ready when its HTTP service answers\n  cua sb create python:3.12-slim --service web=8000 --wait http:web/ -- python -m http.server 8000\n  # The same Linux image as a VM\n  cua sb create linux --kind vm --name dev",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Image: a registry reference (`ghcr.io/org/image:tag`), an alias (`linux`, `ubuntu`, `windows`, `macos[:tahoe|sequoia]`, `omarchy`)",
       "hidden": false,
       "is_optional": true,
       "name": "IMAGE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "The sandbox's command, after `--` (replaces the image's entrypoint): `cua sb create python:3.12-slim --service mcp=8765 -- python -m srv`",
       "hidden": false,
       "is_optional": true,
       "name": "COMMAND",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Start Chromium in it for the cua-driver browser tools (IMAGE defaults to `linux`)",
       "hidden": false,
       "name": "browser",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Open the desktop in the HTML5 viewer once the sandbox is ready (`cua sb view`)",
       "hidden": false,
       "name": "view",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Keep the sandbox (VM or container) when it fails to become ready, to debug it; the ref and how to delete it are printed. Default: a failed create deletes it",
       "hidden": false,
       "name": "keep-on-failure",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "No desktop: only cua-spacesd runs (exec, files, processes, MCP), with no display, window manager or audio. Starts several times faster and fits many more per machine; for shell, CI and RL workloads",
       "hidden": false,
       "name": "headless",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Run the image as it is. By default a container or microVM of an image without cua-spacesd (`alpine`, `node`) gets a static one put in, so exec, files and ports work; with this flag it keeps none",
       "hidden": false,
       "name": "no-spacesd",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "A fork source (a \"bake\" sandbox): a local QEMU VM's guest RAM is a shared file, so `cua sb checkpoint` takes milliseconds and forks of its checkpoints share its pages. Other kinds ignore it",
       "hidden": false,
       "name": "forkable",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "",
       "hidden": true,
       "name": "apply",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "",
       "hidden": true,
       "name": "warm",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "",
       "hidden": true,
       "name": "no-warm",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "create",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Where it runs: local, direct:<addr> (an existing computer running cua-spacesd), or a registered provider. Default: `cua config get default.on` (`CUA_DEFAULT_ON`), else local",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "on",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "WHERE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "What kind of computer: auto (from the image: a container when it has a container rootfs; macOS, Windows and disk-only images are VMs), container, vm, or microvm (the container image booted with its own kernel: Firecracker on Linux with KVM, Apple's Containerization on a Mac with macOS 26)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "kind",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "KIND"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Which engine: auto (the safest available) or one the location offers for the kind. Local: gvisor or runc (containers), qemu or lume (VMs), firecracker, vz or containerization (microVMs). A local sandbox with --sidecar needs `--runtime runc` where gVisor would run (separate gVisor containers cannot share a network namespace)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "runtime",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RUNTIME"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Image tier for an alias: `slim`, `full` (default), Linux `docker` (a VM with dockerd up at boot) or macOS `xcode`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "tier",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TIER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Sandbox name (generated when omitted)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "name",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --browser: open this URL",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "open",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "URL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Install these into the sandbox once it is up: harness ids (`claude-code`) or installables (`blender`, `vscode`, `node`), pinned and checksum-verified (`cua agent ensure` later does the same)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "install",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ID"
      },
      {
       "aliases": [
        "cpus"
       ],
       "default_value": null,
       "env": null,
       "help": "vCPUs",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cpu",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "CPU"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Memory, e.g. 8GB or 4096MB (a bare number is GB)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "memory",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MEMORY"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Guest network: `default` (outbound network, like a Docker container) or `none` (no egress; published ports still work). `none` needs a local QEMU VM; containers and Lume reject it",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "network",
       "possible_values": [
        "default",
        "none"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "default | none",
       "value_name": "NETWORK"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Disk size (accepted; the image decides today)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "disk",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "DISK"
      },
      {
       "aliases": [
        "service"
       ],
       "default_value": null,
       "env": null,
       "help": "Expose a guest port: NAME=PORT (a named service) or PORT (repeatable)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "port",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PORTS"
      },
      {
       "aliases": [
        "wait-for"
       ],
       "default_value": null,
       "env": null,
       "help": "Wait until ready: tcp:SERVICE, http:SERVICE/path, a guest port (tcp:PORT, http:PORT/path), or `desktop` (the desktop session takes input: display, window manager and cua-driver) (repeatable)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "wait",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "WAIT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Readiness budget in seconds, counted once the image is downloaded, the wait for the image's cua-spacesd included (default 600, plus up to 120 for cua-spacesd)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "ready-timeout",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "READY_TIMEOUT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Inject a freshly built binary once the sandbox is up: NAME=PATH (`cua-driver`, `cua-spacesd`) or NAME=PATH:GUEST_PATH (repeatable). It replaces the guest file atomically, is recorded with its sha256 (checked by `cua doctor`) and what runs it is restarted. Needs cua-spacesd in the image",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "overlay",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME=PATH[:GUEST_PATH]"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Environment KEY=VALUE for the sandbox (repeatable)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "env",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ENV"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A sidecar container, reachable from the sandbox at its name (it reaches the sandbox at `main`): IMAGE[,port=PORT][,env=K=V][,name=NAME] (repeatable; `port=` and `env=` repeat too). Local containers; it needs `--runtime runc` where gVisor would run. With sidecars the service names main, sidecars and sc are reserved",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "sidecar",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SIDECARS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Credentials for a private image: env:USER_VAR:PASSWORD_VAR (read from this environment) or aws-ecr[:REGION] (the AWS CLI's login token)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "registry-secret",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REGISTRY_SECRET"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Create from this pool (`cua sb pool create`): the sandbox gets the pool's image and size and takes one of its ready ones in about 0.1 s",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "pool",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "POOL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "How long the platform keeps the sandbox once nothing keeps it alive (`1h`, `900`): a provider sandbox's lifetime (`--on e2b`). Default: the platform's",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "ttl",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "TTL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": "CUA_ENV_TOKEN",
       "help": "spacesd token (direct: sandboxes)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "token",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TOKEN"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Deprecated: use IMAGE",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "image",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "IMAGE_FLAG"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Deprecated: use --wait tcp:PORT",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "wait-tcp",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "WAIT_TCP"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Deprecated: use --wait http:PORT/path",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "wait-http",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "WAIT_HTTP"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A GPU: the runtime's own (`--gpu`), or an option `cua spaces gpus` lists (`paravirtual`: GPU acceleration for a macOS VM on Lume, experimental; `virgl`: QEMU on Linux; `nvidia`: a runc container on Linux; a provider's GPU type)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "gpu",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "OPTION"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A size profile, defaults for what you leave unset: `rollout` (1 vCPU, 1 GiB, no desktop; a local VM gets no display hardware, so many more fit on one machine) for RL rollouts and agent episodes that mostly wait, or `default` (2 vCPUs, 4 GiB)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "profile",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PROFILE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-pool-size",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MAX_POOL_SIZE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "claim-ttl",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "CLAIM_TTL"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox create [OPTIONS] [IMAGE] [-- <COMMAND>...]"
    },
    {
     "abstract": "Deprecated alias of `create`",
     "after_help": "Examples:\n  cua sb launch linux --name dev",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Image: `linux`/`ubuntu`, `macos[:tahoe|sequoia]`, or a registry reference such as `ghcr.io/org/image:tag`",
       "hidden": false,
       "is_optional": true,
       "name": "IMAGE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Deprecated: use `--on local`",
       "hidden": true,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Deprecated: use `--kind vm`",
       "hidden": true,
       "name": "vm",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Keep the sandbox when it fails to become ready (see `sb create --keep-on-failure`)",
       "hidden": false,
       "name": "keep-on-failure",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "",
       "hidden": true,
       "name": "apply",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "",
       "hidden": true,
       "name": "warm",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "",
       "hidden": true,
       "name": "no-warm",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "launch",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Create from this pool (see `sb create --pool`; requires --name)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "pool",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "POOL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "How long the platform keeps the sandbox once nothing keeps it alive (see `sb create --ttl`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "ttl",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "TTL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Where it runs (see `sb create --on`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "on",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "WHERE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Sandbox name",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "name",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "What kind of computer: auto, container, vm or microvm",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "kind",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "KIND"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Which engine (see `sb create --runtime`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "runtime",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RUNTIME"
      },
      {
       "aliases": [
        "cpus"
       ],
       "default_value": null,
       "env": null,
       "help": "vCPUs",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cpu",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "CPU"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Memory, e.g. 8GB or 4096MB (a bare number is GB)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "memory",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MEMORY"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Disk size (accepted for compatibility; sized by the image)",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "disk",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "DISK"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Region (accepted for compatibility; ignored)",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "region",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REGION"
      },
      {
       "aliases": [
        "service"
       ],
       "default_value": null,
       "env": null,
       "help": "Expose a guest port: NAME=PORT or PORT (repeatable)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "port",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PORTS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-pool-size",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MAX_POOL_SIZE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "claim-ttl",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "CLAIM_TTL"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox launch [OPTIONS] [IMAGE]"
    },
    {
     "abstract": "Reattach to a sandbox (NAME or a ref such as `local:NAME`) and print it",
     "after_help": "Examples:\n  cua sb connect dev\n  cua sb connect local:dev",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "connect",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox connect [OPTIONS] <NAME>"
    },
    {
     "abstract": "List sandboxes: local and direct, each with its `location`; `--local` filters",
     "after_help": "Examples:\n  cua sb ls\n  cua sb ls --local --json",
     "aliases": [
      "list"
     ],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Only local sandboxes",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Deprecated: everything is the default",
       "hidden": true,
       "name": "all",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Skip the SIZE column (disk used by each local sandbox), which reads the VM, container and Lume stores",
       "hidden": false,
       "name": "no-size",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "ls",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox ls [OPTIONS]"
    },
    {
     "abstract": "Show one sandbox",
     "after_help": "Examples:\n  cua sb info dev\n  cua sb info local:dev --json\n  # The gRPC URL and token of its cua-spacesd, for your own client\n  cua sb info dev --connection --json",
     "aliases": [
      "get"
     ],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Also print how to call the sandbox's cua-spacesd from your own code: its gRPC URL and bearer token (`authorization: Bearer <token>`). The token is a secret: anyone with it controls the sandbox",
       "hidden": false,
       "name": "connection",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "info",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox info [OPTIONS] <NAME>"
    },
    {
     "abstract": "Suspend (pause/snapshot)",
     "after_help": "Examples:\n  cua sb suspend dev",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "suspend",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox suspend [OPTIONS] <NAME>"
    },
    {
     "abstract": "Resume",
     "after_help": "Examples:\n  cua sb resume dev",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "resume",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox resume [OPTIONS] <NAME>"
    },
    {
     "abstract": "Restart",
     "after_help": "Examples:\n  cua sb restart dev",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "restart",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox restart [OPTIONS] <NAME>"
    },
    {
     "abstract": "Save a local sandbox's state as a named checkpoint: its memory and disk on every kind (a gVisor container, a QEMU or Lume VM, a microVM; it keeps running), the filesystem where an engine cannot save memory. `cua sb fork` starts new sandboxes from it; forks of a QEMU checkpoint share its RAM copy-on-write (and a `--forkable` VM's checkpoints take milliseconds)",
     "after_help": "Examples:\n  cua sb checkpoint dev before-upgrade\n  cua sb fork before-upgrade dev-2\n  # A world to fork many times: kept until unpinned\n  cua sb create linux --kind vm --forkable --name bake\n  cua sb checkpoint bake world --pin\n  cua sb fork world agent-1\n  # A Space another machine of yours provides is checkpointed there\n  cua spaces create linux --kind vm --on host:kvm-a --name src\n  cua sb checkpoint src world\n  cua spaces create checkpoint:world --name agent-2",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`), or a Space another machine of yours provides (its name or id): that machine takes the checkpoint and keeps it",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "The checkpoint's name",
       "hidden": false,
       "is_optional": false,
       "name": "CHECKPOINT",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Pin it: `cua sb checkpoints rm` and `prune` leave it until `cua sb checkpoints unpin`",
       "hidden": false,
       "name": "pin",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Machine-readable output",
       "hidden": false,
       "name": "json",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "checkpoint",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox checkpoint [OPTIONS] <NAME> <CHECKPOINT>"
    },
    {
     "abstract": "Start a new sandbox from a local sandbox (running or stopped) or a checkpoint. A fork restores the saved memory where there is one (in about a second or less) and is a new machine: its own token, keys, machine id and random state",
     "after_help": "Examples:\n  cua sb fork dev dev-copy\n  cua sb fork before-upgrade dev-2",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "A sandbox name or ref, or a checkpoint name (a sandbox wins)",
       "hidden": false,
       "is_optional": false,
       "name": "SOURCE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "The new sandbox's name",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Machine-readable output",
       "hidden": false,
       "name": "json",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "fork",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox fork [OPTIONS] <SOURCE> <NAME>"
    },
    {
     "abstract": "Fork a checkpoint many times at once, on this machine or across your machines, printing each fork as soon as it is ready (or failed). A group's forks (`--group-size`) go to one machine, so they share the checkpoint's memory there; groups spread over the least-loaded machines, the checkpoint is copied (and verified) to a machine that lacks it, and forks of a machine that fails are placed again",
     "after_help": "Examples:\n  cua sb fork-many world --count 8\n  # 64 rollouts, 8 per machine group, across your machines\n  cua sb fork-many world --count 64 --group-size 8 --on auto\n  # Several checkpoints at once\n  cua sb fork-many --group world-a=8 --group world-b=8 --on auto\n  # Fetch from S3 when the machine that holds the checkpoint is away\n  cua sb fork-many world --count 16 --on auto --fallback-s3 my-bucket/cua-snapshots",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The checkpoint (or local sandbox) to fork",
       "hidden": false,
       "is_optional": true,
       "name": "SOURCE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Report forks of a failed machine instead of placing them again",
       "hidden": false,
       "name": "no-retry",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "One JSON object per event",
       "hidden": false,
       "name": "json",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "fork-many",
     "options": [
      {
       "aliases": [],
       "default_value": "1",
       "env": null,
       "help": "How many forks of SOURCE",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "count",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "COUNT"
      },
      {
       "aliases": [],
       "default_value": "0",
       "env": null,
       "help": "Forks per group (0: all in one group)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "group-size",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "GROUP_SIZE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A group `CHECKPOINT=COUNT` (repeatable), instead of SOURCE",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "group",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "CHECKPOINT=COUNT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Where: `local` (default), `auto` (your machines that provide Spaces, this one included), or `host:<machine>`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "on",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ON"
      },
      {
       "aliases": [],
       "default_value": "0",
       "env": null,
       "help": "Forks started at once per machine (0: 4)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "parallel",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "PARALLEL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Names are `<prefix>-<n>`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "prefix",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PREFIX"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A folder every machine mounts (your Cua Volume) to fetch checkpoints from when their machine is away",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "fallback-dir",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "FALLBACK_DIR"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "An S3 `bucket[/prefix]` to fetch checkpoints from when their machine is away (each machine's AWS credentials)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "fallback-s3",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "FALLBACK_S3"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The fallback bucket's region",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "fallback-region",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "FALLBACK_REGION"
      },
      {
       "aliases": [],
       "default_value": "0",
       "env": null,
       "help": "vCPUs each fork is counted as when placing (default: 1; forks of one world are mostly idle)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cpus",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "CPUS"
      },
      {
       "aliases": [],
       "default_value": "0",
       "env": null,
       "help": "Memory (MiB) each fork is counted as when placing (default: the checkpoint's)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "memory-mb",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MEMORY_MB"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox fork-many [OPTIONS] [SOURCE]"
    },
    {
     "abstract": "Upload a checkpoint to a fallback (a folder every machine mounts, or S3), so your other machines copy it from there when this one is away. Files already there are not uploaded again",
     "after_help": "Examples:\n  cua sb publish world --dir \"~/Cua Volume/snapshots\"\n  cua sb publish world --s3 my-bucket/cua-snapshots --region us-west-2",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The checkpoint",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "publish",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A folder every machine mounts",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "dir",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "DIR"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "An S3 `bucket[/prefix]`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "s3",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "S3"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The bucket's region",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "region",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REGION"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox publish [OPTIONS] <NAME>"
    },
    {
     "abstract": "Bake a Docker Compose project into a checkpoint: a local VM of the docker tier (dockerd up at boot), the project uploaded, `docker compose up --wait`, health checks, then a live memory checkpoint. Forks of it (`cua sb fork`) start with the containers already running. The bake Space is deleted afterwards (`--keep` keeps it)",
     "after_help": "Examples:\n  # Bake ./world (compose.yaml: agent, MCP and grader services)\n  cua sb bake ./world --checkpoint world-v1\n  # Check a fork comes up live, with an extra health probe\n  cua sb bake ./world --checkpoint world-v1 --health 'curl -fsS http://127.0.0.1:8000/' --verify-fork\n  # Then start rollouts from it\n  cua sb fork world-v1 rollout-1",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The Docker Compose project directory (holds compose.yaml or docker-compose.yml, and whatever it builds or mounts)",
       "hidden": false,
       "is_optional": false,
       "name": "PROJECT",
       "possible_values": [],
       "repeatable": false,
       "type": "path"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Fork the checkpoint once, check the stack is live in the fork (every service running or healthy, none restarted, the --health commands pass), then delete the fork",
       "hidden": false,
       "name": "verify-fork",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Keep the bake Space after the checkpoint (default: delete it)",
       "hidden": false,
       "name": "keep",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Machine-readable output",
       "hidden": false,
       "name": "json",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "bake",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The checkpoint to save (`cua sb fork CHECKPOINT NAME` starts from it)",
       "hidden": false,
       "is_optional": false,
       "multiple_values": false,
       "name": "checkpoint",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "CHECKPOINT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The image: an alias, a reference or a local disk path. Default: the docker tier, `linux --tier docker` (a Linux image with Docker)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "image",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "IMAGE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Tier for an alias IMAGE (`docker` for a Docker-ready Linux VM)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "tier",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TIER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The bake Space's name (default `bake-<checkpoint>`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "name",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME"
      },
      {
       "aliases": [
        "cpus"
       ],
       "default_value": null,
       "env": null,
       "help": "vCPUs of the bake Space (forks get the same)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cpu",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "CPU"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Memory of the bake Space, e.g. 4GB (forks get the same)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "memory",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MEMORY"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Compose files, relative to the project (repeatable; default: compose's own lookup, compose.yaml / docker-compose.yml)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "file",
       "possible_values": [],
       "repeatable": true,
       "short_name": "f",
       "takes_value": true,
       "type": "string",
       "value_name": "FILE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Compose project name (default: the directory name)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "project-name",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PROJECT_NAME"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Where the project lands in the guest (default /opt/cua-bake/<project>)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "dest",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "GUEST_DIR"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "`docker save` tarballs to `docker load` before `compose up`, for images the guest cannot pull (repeatable)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "load",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "path",
       "value_name": "TAR"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A guest shell command, run as root in the project directory, that must exit 0 before the checkpoint (retried until --health-timeout; repeatable). `compose up --wait` already waits for healthchecks",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "health",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "CMD"
      },
      {
       "aliases": [],
       "default_value": "600",
       "env": null,
       "help": "Budget for `compose up --wait` and each --health command, seconds",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "health-timeout",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "HEALTH_TIMEOUT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A guest shell command, run as root in the project directory after the stack is healthy and before the checkpoint (repeatable): state forks should start with, e.g. iptables rules or a warmed cache",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "run",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "CMD"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox bake [OPTIONS] --checkpoint <CHECKPOINT> <PROJECT>"
    },
    {
     "abstract": "Pools: sandboxes of one kind kept ready on this machine, so that `cua sb create --pool NAME` takes one in about 0.1 s. Without pools, the daemon keeps sandboxes ready only where repeated creates pay for it (`cua daemon status` says why)",
     "after_help": "Examples:\n  # Always 2 Linux desktops ready, up to 8 while creates come fast\n  cua sb pool create linux --name agents --min 2 --max 8\n  cua sb create --pool agents --name a1\n  cua sb pool ls\n  cua sb pool rm agents",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "pool",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [
      {
       "abstract": "Create a pool, or update the pool of that name",
       "after_help": "Examples:\n  cua sb pool create linux --name agents --min 2 --max 8\n  cua sb pool create linux --name big --cpu 4 --memory 8GB --idle 30m",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "The image its sandboxes run",
         "hidden": false,
         "is_optional": false,
         "name": "IMAGE",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [
        {
         "aliases": [],
         "default_value": false,
         "env": null,
         "help": "Machine-readable output",
         "hidden": false,
         "name": "json",
         "repeatable": false,
         "short_name": null,
         "takes_value": false
        }
       ],
       "hidden": false,
       "hidden_aliases": [],
       "name": "create",
       "options": [
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "The pool's name (lower-case letters, digits, '-'; default: a new one). The name of an existing pool updates it",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "name",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "NAME"
        },
        {
         "aliases": [],
         "default_value": "1",
         "env": null,
         "help": "Sandboxes kept ready at all times (one starts again as soon as one is created from the pool)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "min",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "integer",
         "value_name": "MIN"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Most kept ready, not counting those created from the pool (default: --min); above --min only while creates come faster than sandboxes start",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "max",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "integer",
         "value_name": "MAX"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "After this long without a create from the pool it keeps none ready, until the next create (`30m`, `2h`; default: never)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "idle",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "integer",
         "value_name": "IDLE"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Where its sandboxes run (only `local` has pools today)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "on",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "WHERE"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "What kind of machine (auto, container, vm, microvm)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "kind",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "KIND"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Which engine (auto, gvisor, runc, ...)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "runtime",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "RUNTIME"
        },
        {
         "aliases": [
          "cpus"
         ],
         "default_value": null,
         "env": null,
         "help": "vCPUs of each sandbox",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "cpu",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "integer",
         "value_name": "CPU"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Memory of each sandbox (`4GB`, `4096MB`)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "memory",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "MEMORY"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Guest environment (repeat)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "env",
         "possible_values": [],
         "repeatable": true,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "ENV"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox pool create [OPTIONS] <IMAGE>"
      },
      {
       "abstract": "List the pools, with what each holds now",
       "after_help": "Examples:\n  cua sb pool ls\n  cua sb pool ls --json",
       "aliases": [
        "list"
       ],
       "arguments": [],
       "flags": [
        {
         "aliases": [],
         "default_value": false,
         "env": null,
         "help": "Machine-readable output",
         "hidden": false,
         "name": "json",
         "repeatable": false,
         "short_name": null,
         "takes_value": false
        }
       ],
       "hidden": false,
       "hidden_aliases": [],
       "name": "ls",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox pool ls [OPTIONS]"
      },
      {
       "abstract": "Delete a pool (its ready sandboxes go; those created from it stay)",
       "after_help": "Examples:\n  cua sb pool rm agents",
       "aliases": [
        "delete"
       ],
       "arguments": [
        {
         "default_value": null,
         "help": "The pool's name",
         "hidden": false,
         "is_optional": false,
         "name": "NAME",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "rm",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox pool rm [OPTIONS] <NAME>"
      }
     ],
     "usage": "cua sandbox pool [OPTIONS] <COMMAND>"
    },
    {
     "abstract": "List checkpoints; delete, pin or unpin one; or prune every unpinned one (`checkpoints rm|pin|unpin NAME`, `checkpoints prune`)",
     "after_help": "Examples:\n  cua sb checkpoints\n  cua sb checkpoints rm before-upgrade\n  cua sb checkpoints pin world\n  cua sb checkpoints prune",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Machine-readable output",
       "hidden": false,
       "name": "json",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "checkpoints",
     "options": [],
     "subcommand_optional": true,
     "subcommands": [
      {
       "abstract": "Delete a checkpoint, here and on every machine of yours that holds a copy (forks made from it keep running)",
       "after_help": "Examples:\n  cua sb checkpoints rm before-upgrade",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "The checkpoint's name",
         "hidden": false,
         "is_optional": false,
         "name": "NAME",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "rm",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox checkpoints rm [OPTIONS] <NAME>"
      },
      {
       "abstract": "Pin a checkpoint: a fork source to keep (`rm` and `prune` leave it until it is unpinned)",
       "after_help": "Examples:\n  cua sb checkpoints pin world",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "The checkpoint's name",
         "hidden": false,
         "is_optional": false,
         "name": "NAME",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "pin",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox checkpoints pin [OPTIONS] <NAME>"
      },
      {
       "abstract": "Unpin a checkpoint (`rm` and `prune` delete it again)",
       "after_help": "Examples:\n  cua sb checkpoints unpin world",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "The checkpoint's name",
         "hidden": false,
         "is_optional": false,
         "name": "NAME",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "unpin",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox checkpoints unpin [OPTIONS] <NAME>"
      },
      {
       "abstract": "Delete every checkpoint that is not pinned (forks made from them keep running)",
       "after_help": "Examples:\n  cua sb checkpoints prune",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "prune",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox checkpoints prune [OPTIONS]"
      }
     ],
     "usage": "cua sandbox checkpoints [OPTIONS] [COMMAND]"
    },
    {
     "abstract": "Removed: Cua Cloud has ended",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "name": "ARGS",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": true,
     "hidden_aliases": [],
     "name": "keep-alive",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox keep-alive [OPTIONS] [ARGS]..."
    },
    {
     "abstract": "Delete a sandbox",
     "after_help": "Examples:\n  cua sb rm dev\n  # Without the prompt (required in scripts and agents)\n  cua sb rm local:dev --force",
     "aliases": [
      "delete"
     ],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Skip the confirmation prompt. Required when there is no terminal to ask on (scripts, agents): without it nothing is deleted",
       "hidden": false,
       "name": "force",
       "repeatable": false,
       "short_name": "f",
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "rm",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox rm [OPTIONS] <NAME>"
    },
    {
     "abstract": "Run a command (joined into one shell line, as `sh -c`). Exits with the command's own status, or 124 when it ran out of time. A local Lume sandbox without cua-spacesd runs it via SSH (`lume ssh`)",
     "after_help": "Examples:\n  cua sb exec dev uname -a\n  cua sb exec dev 'ls /tmp | wc -l'\n  # A long job: no time limit\n  cua sb exec dev --timeout 0 ./crawl.sh\n  # A long-lived stdio stream, like `docker exec -i`: argv, not a shell line\n  cua sb exec -i dev -- bash -c 'wc -c'",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Command and arguments",
       "hidden": false,
       "is_optional": false,
       "name": "COMMAND",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Stream: run the command as argv (no shell), forward this command's stdin, write stdout and stderr as they arrive, set no time limit, pass SIGINT/SIGTERM/SIGHUP on, and kill the command when this process ends. Exits with the command's status (128 + n for signal n)",
       "hidden": false,
       "name": "stdin",
       "repeatable": false,
       "short_name": "i",
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "exec",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Run as this guest user",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "user",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "USER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Start in this guest directory",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cwd",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "CWD"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Stop the command after this many seconds (0: no limit)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "timeout",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "SECONDS"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox exec [OPTIONS] <NAME> <COMMAND>..."
    },
    {
     "abstract": "Run a command in new Spaces, `--count` times (each in its own Space, deleted afterwards): on this machine, or with `--on auto` on the least-loaded of your machines. A run of your machines keeps going when this one sleeps",
     "after_help": "Examples:\n  cua sb run -- uname -a\n  # 200 headless browser sessions on all your machines\n  cua sb run --on auto --count 200 -- sh -c 'chromium --headless --no-sandbox --dump-dom https://example.com | wc -c'\n  # On one machine, and come back later\n  cua sb run --on mac-mini --count 50 --detach -- ./job.sh",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The command (after `--`)",
       "hidden": false,
       "is_optional": false,
       "name": "COMMAND",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Submit and print the run's id without waiting",
       "hidden": false,
       "name": "detach",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "run",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Where: omitted or `local` (this machine), `auto` (the least-loaded of your machines that provide Spaces), or one machine by name",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "on",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ON"
      },
      {
       "aliases": [],
       "default_value": "1",
       "env": null,
       "help": "How many times to run it, each in its own new Space",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "count",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "COUNT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Image of each Space (default: the canonical Linux image)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "image",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "IMAGE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "`container`, `vm` or `microvm` (default: what the image is)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "kind",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "KIND"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A runtime (`gvisor`, `runc`, `firecracker`, ...)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "runtime",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RUNTIME"
      },
      {
       "aliases": [],
       "default_value": "1",
       "env": null,
       "help": "CPUs reserved for each",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cpus",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "number",
       "value_name": "CPUS"
      },
      {
       "aliases": [],
       "default_value": "1024",
       "env": null,
       "help": "Memory reserved for each, in MiB",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "memory",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MEMORY"
      },
      {
       "aliases": [],
       "default_value": "10m",
       "env": null,
       "help": "How long each may run",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "timeout",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TIMEOUT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "`KEY=VALUE` for the command's environment",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "env",
       "possible_values": [],
       "repeatable": true,
       "short_name": "e",
       "takes_value": true,
       "type": "string",
       "value_name": "ENV"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A file each run leaves behind, returned with its result",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "result",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RESULT"
      },
      {
       "aliases": [],
       "default_value": "0",
       "env": null,
       "help": "Most at once (default: as many as the machines take)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "concurrency",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "CONCURRENCY"
      },
      {
       "aliases": [],
       "default_value": "0",
       "env": null,
       "help": "Times a job may be lost (its machine went away) and run again",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-attempts",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MAX_ATTEMPTS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only machines of this OS (`linux`, `macos`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "os",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "OS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only machines of this CPU architecture (`x86_64`, `arm64`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "arch",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ARCH"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The run's id (default: a new one). Submitting the same id again adds nothing twice",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "id",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ID"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox run [OPTIONS] <COMMAND>..."
    },
    {
     "abstract": "Runs so far, one run's jobs, or one job with its output",
     "after_help": "Examples:\n  cua sb runs\n  cua sb runs p-1a2b3c4d --state failed\n  cua sb runs p-1a2b3c4d --job 42\n  cua sb runs p-1a2b3c4d --cancel",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "A run: its jobs",
       "hidden": false,
       "is_optional": true,
       "name": "RUN",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Cancel the run (or the job with `--job`)",
       "hidden": false,
       "name": "cancel",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "With a run and `--json`: each job's output too",
       "hidden": false,
       "name": "output",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "runs",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "One job of the run, with its output",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "job",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "JOB"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only jobs in this state (`failed`, `error`, `running`, ...)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "state",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "STATE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Runs of this machine only (`local`) or of all your machines (`auto`, the default)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "on",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ON"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox runs [OPTIONS] [RUN]"
    },
    {
     "abstract": "Interactive shell (PTY), or run a command in a PTY",
     "after_help": "Examples:\n  cua sb shell dev\n  cua sb shell dev top",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Command to run instead of the login shell",
       "hidden": false,
       "is_optional": true,
       "name": "COMMAND",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "shell",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Terminal width (default: this terminal's)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cols",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "COLS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Terminal height (default: this terminal's)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "rows",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "ROWS"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox shell [OPTIONS] <NAME> [COMMAND]..."
    },
    {
     "abstract": "Copy files: `cp NAME:/guest/path LOCAL` or `cp LOCAL NAME:/guest/path` (NAME may be a ref: `cp local:box:/tmp/x .`)",
     "after_help": "Examples:\n  # Upload\n  cua sb cp ./notes.txt dev:/tmp/notes.txt\n  # Download\n  cua sb cp dev:/tmp/notes.txt .",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Source: a local path or `NAME:/guest/path`",
       "hidden": false,
       "is_optional": false,
       "name": "SRC",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Destination: a local path or `NAME:/guest/path`",
       "hidden": false,
       "is_optional": false,
       "name": "DST",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "cp",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox cp [OPTIONS] <SRC> <DST>"
    },
    {
     "abstract": "Inject freshly built binaries into a running sandbox (see `create --overlay`): NAME=PATH or NAME=PATH:GUEST_PATH",
     "after_help": "Examples:\n  # The cua-driver under test, then check that it is what runs\n  cua sb overlay dev cua-driver=./target/release/cua-driver\n  cua doctor dev --expect cua-driver=sha256:<sha256>\n  # The daemon too (restarts it and waits for the new build)\n  cua sb overlay dev cua-spacesd=./target/release/cua-spacesd",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "NAME=PATH[:GUEST_PATH] (repeatable)",
       "hidden": false,
       "is_optional": false,
       "name": "OVERLAYS",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "overlay",
     "options": [
      {
       "aliases": [],
       "default_value": "180",
       "env": null,
       "help": "Budget for a cua-spacesd restart, in seconds",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "timeout",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "TIMEOUT"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox overlay [OPTIONS] <NAME> <OVERLAYS>..."
    },
    {
     "abstract": "Show logs: the backend console (QEMU serial, container) when there is one, else the guest system log through the spacesd",
     "after_help": "Examples:\n  cua sb logs dev\n  cua sb logs dev -n 50 --source guest",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "logs",
     "options": [
      {
       "aliases": [],
       "default_value": "200",
       "env": null,
       "help": "Lines from the end",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "tail",
       "possible_values": [],
       "repeatable": false,
       "short_name": "n",
       "takes_value": true,
       "type": "integer",
       "value_name": "TAIL"
      },
      {
       "aliases": [],
       "default_value": "auto",
       "env": null,
       "help": "auto, console or guest",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "source",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SOURCE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox logs [OPTIONS] <NAME>"
    },
    {
     "abstract": "Forward a guest port: `port-forward NAME PORT[:LOCAL]` (a local sandbox's port not published at create tunnels through cua-spacesd when the image has it)",
     "after_help": "Examples:\n  # Guest port 8080 on localhost:8080 until Ctrl-C\n  cua sb port-forward dev 8080\n  # Guest port 5432 on localhost:15432\n  cua sb port-forward local:dev 5432:15432",
     "aliases": [
      "forward"
     ],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "PORT or PORT:LOCAL_PORT",
       "hidden": false,
       "is_optional": false,
       "name": "SPEC",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Print the target and exit instead of forwarding until Ctrl-C",
       "hidden": false,
       "name": "no-wait",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "port-forward",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox port-forward [OPTIONS] <NAME> <SPEC>"
    },
    {
     "abstract": "Print a URL for a named service: usable from this computer (default), or `--public` for a shareable URL that expires (`--ttl`, default 1h; a token URL served by the cua daemon)",
     "after_help": "Examples:\n  cua sb url dev web\n  # A shareable URL for 10 minutes\n  cua sb url local:dev web --public --ttl 10m",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Service name (from `--service` at create time)",
       "hidden": false,
       "is_optional": false,
       "name": "SERVICE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "A shareable URL that expires",
       "hidden": false,
       "name": "public",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "url",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Lifetime of a --public URL (`10m`, `1h`, `3600`; 60 s to 24 h)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "ttl",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "TTL"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox url [OPTIONS] <NAME> <SERVICE>"
    },
    {
     "abstract": "Save a screenshot (PNG). A local Lume sandbox without cua-spacesd is captured via VNC",
     "after_help": "Examples:\n  cua sb screenshot dev -o desktop.png",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "screenshot",
     "options": [
      {
       "aliases": [],
       "default_value": "screenshot.png",
       "env": null,
       "help": "Output file (PNG)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "output",
       "possible_values": [],
       "repeatable": false,
       "short_name": "o",
       "takes_value": true,
       "type": "path",
       "value_name": "OUTPUT"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox screenshot [OPTIONS] <NAME>"
    },
    {
     "abstract": "Talk to an MCP server a sandbox serves: `mcp NAME SERVICE tools`, `mcp NAME SERVICE call TOOL '{\"a\":1}'`. Generic streamable HTTP over the service; no cua-spacesd needed",
     "after_help": "Examples:\n  cua sb mcp dev mcp tools\n  cua sb mcp dev mcp call echo '{\"text\":\"hi\"}'",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Service name (for example `mcp`, or `port-8765`)",
       "hidden": false,
       "is_optional": false,
       "name": "SERVICE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "mcp",
     "options": [
      {
       "aliases": [],
       "default_value": "/mcp",
       "env": null,
       "help": "Endpoint path on the service",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "path",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PATH"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [
      {
       "abstract": "The endpoint URL and headers, for any MCP client. Credential headers print masked (`Bearer ****`) unless `--show-secrets`",
       "after_help": "Examples:\n  cua sb mcp dev mcp config",
       "aliases": [],
       "arguments": [],
       "flags": [
        {
         "aliases": [],
         "default_value": false,
         "env": null,
         "help": "Print credential header values in full",
         "hidden": false,
         "name": "show-secrets",
         "repeatable": false,
         "short_name": null,
         "takes_value": false
        }
       ],
       "hidden": false,
       "hidden_aliases": [],
       "name": "config",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox mcp <NAME> <SERVICE> config [OPTIONS]"
      },
      {
       "abstract": "Server name, version and negotiated protocol revision",
       "after_help": "Examples:\n  cua sb mcp dev mcp info",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "info",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox mcp <NAME> <SERVICE> info [OPTIONS]"
      },
      {
       "abstract": "List tools",
       "after_help": "Examples:\n  cua sb mcp dev mcp tools",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "tools",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox mcp <NAME> <SERVICE> tools [OPTIONS]"
      },
      {
       "abstract": "Call a tool with a JSON object of arguments",
       "after_help": "Examples:\n  cua sb mcp dev mcp call echo '{\"text\":\"hi\"}'\n  cua sb mcp dev mcp call screenshot --out ./shots",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Tool name",
         "hidden": false,
         "is_optional": false,
         "name": "TOOL",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        },
        {
         "default_value": null,
         "help": "Arguments (JSON object). Default `{}`",
         "hidden": false,
         "is_optional": true,
         "name": "ARGUMENTS",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "call",
       "options": [
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Save image, audio and blob content here instead of summarizing",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "out",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "path",
         "value_name": "OUT"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox mcp <NAME> <SERVICE> call [OPTIONS] <TOOL> [ARGUMENTS]"
      },
      {
       "abstract": "List resources",
       "after_help": "Examples:\n  cua sb mcp dev mcp resources",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "resources",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox mcp <NAME> <SERVICE> resources [OPTIONS]"
      },
      {
       "abstract": "List resource templates",
       "after_help": "Examples:\n  cua sb mcp dev mcp templates",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "templates",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox mcp <NAME> <SERVICE> templates [OPTIONS]"
      },
      {
       "abstract": "Read a resource",
       "after_help": "Examples:\n  cua sb mcp dev mcp read file:///tmp/report.txt",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Resource URI",
         "hidden": false,
         "is_optional": false,
         "name": "URI",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "read",
       "options": [
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Save blob contents here instead of summarizing",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "out",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "path",
         "value_name": "OUT"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox mcp <NAME> <SERVICE> read [OPTIONS] <URI>"
      },
      {
       "abstract": "List prompts",
       "after_help": "Examples:\n  cua sb mcp dev mcp prompts",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "prompts",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox mcp <NAME> <SERVICE> prompts [OPTIONS]"
      },
      {
       "abstract": "Render a prompt with a JSON object of string arguments",
       "after_help": "Examples:\n  cua sb mcp dev mcp prompt summarize '{\"topic\":\"logs\"}'",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Prompt name",
         "hidden": false,
         "is_optional": false,
         "name": "NAME",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        },
        {
         "default_value": null,
         "help": "Arguments (JSON object of strings). Default `{}`",
         "hidden": false,
         "is_optional": true,
         "name": "ARGUMENTS",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "prompt",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox mcp <NAME> <SERVICE> prompt [OPTIONS] <NAME> [ARGUMENTS]"
      },
      {
       "abstract": "Any other method (for example `skills/list`), printing the result",
       "after_help": "Examples:\n  cua sb mcp dev mcp request skills/list",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "JSON-RPC method",
         "hidden": false,
         "is_optional": false,
         "name": "METHOD",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        },
        {
         "default_value": null,
         "help": "Params (JSON object)",
         "hidden": false,
         "is_optional": true,
         "name": "PARAMS",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "request",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua sandbox mcp <NAME> <SERVICE> request [OPTIONS] <METHOD> [PARAMS]"
      }
     ],
     "usage": "cua sandbox mcp [OPTIONS] <NAME> <SERVICE> <COMMAND>"
    },
    {
     "abstract": "Open the sandbox desktop in the browser (the cua-spacesd HTML5 viewer). A local Lume sandbox without cua-spacesd opens its VNC display with `lume attach`",
     "after_help": "Examples:\n  cua sb view dev\n  # Watch only, print the link instead of opening it\n  cua sb view dev --view-only --no-open\n  # An image that ships its own web display instead of cua-spacesd\n  cua sb view old-box --service web",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Watch only: no input, clipboard, files or microphone",
       "hidden": false,
       "name": "view-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Print the link without opening a browser",
       "hidden": false,
       "name": "no-open",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "view",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Open this web service of the sandbox instead of the viewer (for images without cua-spacesd that serve their own display page)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "service",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SERVICE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Guest folder for uploads and folder sharing (default `~`; `none` turns files off)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "files",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "FILES"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Link lifetime (for example `1h`, `30m`). Default 1h",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "ttl",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TTL"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox view [OPTIONS] <NAME>"
    },
    {
     "abstract": "Deprecated spelling of `view` (it opens the HTML5 viewer)",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Watch only: no input, clipboard, files or microphone",
       "hidden": false,
       "name": "view-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Print the link without opening a browser",
       "hidden": false,
       "name": "no-open",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": true,
     "hidden_aliases": [],
     "name": "vnc",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Open this web service of the sandbox instead of the viewer (for images without cua-spacesd that serve their own display page)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "service",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SERVICE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Guest folder for uploads and folder sharing (default `~`; `none` turns files off)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "files",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "FILES"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Link lifetime (for example `1h`, `30m`). Default 1h",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "ttl",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TTL"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox vnc [OPTIONS] <NAME>"
    },
    {
     "abstract": "Headless stream viewer for image gates and measurements: opens a media session, sends `--action` input on it and prints timings as JSON",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref (`local:NAME`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Report the agent participants on the Space's presence before and after the actions (`presence`): a viewer's input must add none, only the viewer's own cursor",
       "hidden": false,
       "name": "presence-check",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Look NAME up among local sandboxes only (same as `local:NAME`)",
       "hidden": false,
       "name": "local",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Removed: Cua Cloud has ended",
       "hidden": true,
       "name": "cloud",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": true,
     "hidden_aliases": [],
     "name": "stream-probe",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Stream this window (an id from `cua do window ls`) instead of the primary display",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "window",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "WINDOW"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Stream the first window whose app or title contains this (as `cua do window ls APP` lists them), focused windows first",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "window-app",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "WINDOW_APP"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Input policy: `allow_activation` (the desktop default), `background_only` (the window default; reopened with `allow_activation` when the Space refuses background input, as the viewers do) or `view_only`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "policy",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "POLICY"
      },
      {
       "aliases": [],
       "default_value": "30",
       "env": null,
       "help": "Frame-rate cap requested from the Space",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-fps",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MAX_FPS"
      },
      {
       "aliases": [],
       "default_value": "0",
       "env": null,
       "help": "Long-edge cap in pixels (0: native)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-dimension",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MAX_DIMENSION"
      },
      {
       "aliases": [],
       "default_value": "5",
       "env": null,
       "help": "Seconds to count frames for the frame rate",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "seconds",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "number",
       "value_name": "SECONDS"
      },
      {
       "aliases": [],
       "default_value": "10",
       "env": null,
       "help": "Ping round trips on the media socket",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "pings",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "PINGS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Input to send through the session, in order (repeatable): `click:X,Y`, `type:TEXT`, `key:NAME[+command|+shift|+control|+option]`, `scroll:X,Y,DY` or `wait:MS`. X and Y are normalized to the stream (0 to 1); DY is in wheel clicks, positive scrolls down",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "action",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ACTION"
      },
      {
       "aliases": [],
       "default_value": "30",
       "env": null,
       "help": "Seconds to wait for each action's acknowledgement and change",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "action-timeout",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "number",
       "value_name": "ACTION_TIMEOUT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Save the last frame here as PNG (needs the Cua Spaces `cua`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "save-frame",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "path",
       "value_name": "SAVE_FRAME"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua sandbox stream-probe [OPTIONS] <NAME>"
    }
   ],
   "usage": "cua sandbox [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "User defaults (~/.cua/config.toml): where sandboxes run when --on is not given (default.on), the default kind and runtime",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "config",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Every setting: its effective value and where it comes from (env, config or default)",
     "after_help": "Examples:\n  cua config list\n  cua config list --json",
     "aliases": [
      "ls"
     ],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "list",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua config list [OPTIONS]"
    },
    {
     "abstract": "One setting's effective value",
     "after_help": "Examples:\n  cua config get default.on",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Setting (`default.on`, `default.kind`, `default.runtime`, `pool.auto`, `pool.memory_percent`, `pool.warm`; `cua config list` shows them all)",
       "hidden": false,
       "is_optional": false,
       "name": "KEY",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "get",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua config get [OPTIONS] <KEY>"
    },
    {
     "abstract": "Write a setting to the config file",
     "after_help": "Examples:\n  # Create sandboxes in your AWS account unless --on says otherwise\n  cua config set default.on aws\n  # Back to this computer\n  cua config set default.on local\n  # Prefer VMs when the image offers both\n  cua config set default.kind vm\n  # A dedicated host: keep 8 Linux desktops ready to claim\n  cua config set pool.warm ghcr.io/trycua/linux:24.04-slim=8\n  # Only explicit pools on this machine\n  cua config set pool.auto off",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Setting",
       "hidden": false,
       "is_optional": false,
       "name": "KEY",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Value (checked: `default.on` takes local, aws, gcp, modal or a provider)",
       "hidden": false,
       "is_optional": false,
       "name": "VALUE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "set",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua config set [OPTIONS] <KEY> <VALUE>"
    },
    {
     "abstract": "Remove a setting from the config file (the environment variable or the built-in default applies again)",
     "after_help": "Examples:\n  cua config unset default.on",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Setting",
       "hidden": false,
       "is_optional": false,
       "name": "KEY",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "unset",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua config unset [OPTIONS] <KEY>"
    },
    {
     "abstract": "The config file's path",
     "after_help": "Examples:\n  cua config path",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "path",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua config path [OPTIONS]"
    }
   ],
   "usage": "cua config [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Serve the HTML5 viewer for every sandbox on one loopback port",
   "after_help": "Examples:\n  # List your sandboxes in the browser and open any of them\n  cua viewer\n  # Fixed port, print the URL only\n  cua viewer --listen 127.0.0.1:8211 --no-open",
   "aliases": [],
   "arguments": [],
   "flags": [
    {
     "aliases": [],
     "default_value": false,
     "env": null,
     "help": "Print the URL without opening a browser",
     "hidden": false,
     "name": "no-open",
     "repeatable": false,
     "short_name": null,
     "takes_value": false
    }
   ],
   "hidden": false,
   "hidden_aliases": [],
   "name": "viewer",
   "options": [
    {
     "aliases": [],
     "default_value": "127.0.0.1:0",
     "env": null,
     "help": "Address to listen on (loopback only)",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "listen",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "LISTEN"
    }
   ],
   "subcommand_optional": false,
   "subcommands": [],
   "usage": "cua viewer [OPTIONS]"
  },
  {
   "abstract": "One-shot computer actions against the selected target",
   "after_help": "Examples:\n  # Act on a sandbox, then take a screenshot\n  cua do switch dev\n  cua do screenshot\n  # A relay Space (`cua spaces ls`)\n  cua do switch relay:0123abcd4567ef89",
   "aliases": [],
   "arguments": [],
   "flags": [
    {
     "aliases": [],
     "default_value": false,
     "env": null,
     "help": "Disable trajectory recording for this command",
     "hidden": false,
     "name": "no-record",
     "repeatable": false,
     "short_name": null,
     "takes_value": false
    }
   ],
   "hidden": false,
   "hidden_aliases": [],
   "name": "do",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Select the target: a sandbox name or ref, a relay Space (`relay:<id>`), `host`, `url <URL>`, or a legacy `<provider> <name>` pair",
     "after_help": "Examples:\n  cua do switch dev\n  cua do switch relay:0123abcd4567ef89\n  # This computer (after `cua do-host-consent`)\n  cua do switch host",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Sandbox name or ref, `relay:<id>`, `host`, `url`, or a legacy provider word",
       "hidden": false,
       "is_optional": false,
       "name": "TARGET",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "The URL after `url`, or the sandbox name after a provider word",
       "hidden": false,
       "is_optional": true,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "switch",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": "CUA_ENV_TOKEN",
       "help": "spacesd token (`url` and `host`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "token",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TOKEN"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Sandbox name to register a `url` target under",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "as",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ALIAS"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do switch [OPTIONS] <TARGET> [NAME]"
    },
    {
     "abstract": "Show the current target and zoom state",
     "after_help": "Examples:\n  cua do status",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "status",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do status [OPTIONS]"
    },
    {
     "abstract": "List targets (optionally of one provider)",
     "after_help": "Examples:\n  cua do ls",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Only targets of this provider",
       "hidden": false,
       "is_optional": true,
       "name": "PROVIDER",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "ls",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do ls [OPTIONS] [PROVIDER]"
    },
    {
     "abstract": "Crop screenshots to a window and map coordinates into it",
     "after_help": "Examples:\n  cua do zoom Firefox",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Window title or app name",
       "hidden": false,
       "is_optional": false,
       "name": "WINDOW_NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "zoom",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do zoom [OPTIONS] <WINDOW_NAME>"
    },
    {
     "abstract": "Return to full-screen screenshots",
     "after_help": "Examples:\n  cua do unzoom",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "unzoom",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do unzoom [OPTIONS]"
    },
    {
     "abstract": "Take a screenshot (saved to ~/.cua/screenshots, newest 20 kept, unless --save)",
     "after_help": "Examples:\n  cua do screenshot\n  cua do screenshot --save desktop.png",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "screenshot",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Save the PNG here",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "save",
       "possible_values": [],
       "repeatable": false,
       "short_name": "s",
       "takes_value": true,
       "type": "path",
       "value_name": "SAVE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do screenshot [OPTIONS]"
    },
    {
     "abstract": "Screenshot plus an AI summary of the screen and its interactive elements (needs ANTHROPIC_API_KEY)",
     "after_help": "Examples:\n  cua do snapshot\n  cua do snapshot find the search box",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "What to focus the summary on",
       "hidden": false,
       "is_optional": true,
       "name": "INSTRUCTIONS",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "snapshot",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Model (default `claude-haiku-4-5`, or CUA_SNAPSHOT_MODEL)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "model",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MODEL"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do snapshot [OPTIONS] [INSTRUCTIONS]..."
    },
    {
     "abstract": "Click at image coordinates",
     "after_help": "Examples:\n  cua do click 640 360\n  cua do click 640 360 right",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "X in screenshot pixels",
       "hidden": false,
       "is_optional": false,
       "name": "X",
       "possible_values": [],
       "repeatable": false,
       "type": "integer"
      },
      {
       "default_value": null,
       "help": "Y in screenshot pixels",
       "hidden": false,
       "is_optional": false,
       "name": "Y",
       "possible_values": [],
       "repeatable": false,
       "type": "integer"
      },
      {
       "default_value": "left",
       "help": "Mouse button",
       "hidden": false,
       "is_optional": true,
       "name": "BUTTON",
       "possible_values": [
        "left",
        "right",
        "middle"
       ],
       "repeatable": false,
       "type": "left | right | middle"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "click",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do click [OPTIONS] <X> <Y> [BUTTON]"
    },
    {
     "abstract": "Double-click at image coordinates",
     "after_help": "Examples:\n  cua do dclick 640 360",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "X in screenshot pixels",
       "hidden": false,
       "is_optional": false,
       "name": "X",
       "possible_values": [],
       "repeatable": false,
       "type": "integer"
      },
      {
       "default_value": null,
       "help": "Y in screenshot pixels",
       "hidden": false,
       "is_optional": false,
       "name": "Y",
       "possible_values": [],
       "repeatable": false,
       "type": "integer"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "dclick",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do dclick [OPTIONS] <X> <Y>"
    },
    {
     "abstract": "Move the cursor (image coordinates)",
     "after_help": "Examples:\n  cua do move 640 360",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "X in screenshot pixels",
       "hidden": false,
       "is_optional": false,
       "name": "X",
       "possible_values": [],
       "repeatable": false,
       "type": "integer"
      },
      {
       "default_value": null,
       "help": "Y in screenshot pixels",
       "hidden": false,
       "is_optional": false,
       "name": "Y",
       "possible_values": [],
       "repeatable": false,
       "type": "integer"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "move",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do move [OPTIONS] <X> <Y>"
    },
    {
     "abstract": "Type text",
     "after_help": "Examples:\n  cua do type 'hello world'",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Text to type",
       "hidden": false,
       "is_optional": false,
       "name": "TEXT",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "type",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do type [OPTIONS] <TEXT>"
    },
    {
     "abstract": "Press a key (enter, escape, tab, ...)",
     "after_help": "Examples:\n  cua do key enter",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Key name",
       "hidden": false,
       "is_optional": false,
       "name": "KEY",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "key",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do key [OPTIONS] <KEY>"
    },
    {
     "abstract": "Keyboard shortcut (cmd+c, ctrl+shift+s)",
     "after_help": "Examples:\n  cua do hotkey ctrl+shift+s",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Keys joined with `+`",
       "hidden": false,
       "is_optional": false,
       "name": "KEYS",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "hotkey",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do hotkey [OPTIONS] <KEYS>"
    },
    {
     "abstract": "Scroll in a direction",
     "after_help": "Examples:\n  cua do scroll down\n  cua do scroll up 10",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Direction",
       "hidden": false,
       "is_optional": false,
       "name": "DIRECTION",
       "possible_values": [
        "up",
        "down",
        "left",
        "right"
       ],
       "repeatable": false,
       "type": "up | down | left | right"
      },
      {
       "default_value": "3",
       "help": "Scroll steps",
       "hidden": false,
       "is_optional": true,
       "name": "AMOUNT",
       "possible_values": [],
       "repeatable": false,
       "type": "integer"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "scroll",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do scroll [OPTIONS] <DIRECTION> [AMOUNT]"
    },
    {
     "abstract": "Drag between two points (image coordinates)",
     "after_help": "Examples:\n  cua do drag 100 200 400 200",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Start X in screenshot pixels",
       "hidden": false,
       "is_optional": false,
       "name": "X1",
       "possible_values": [],
       "repeatable": false,
       "type": "integer"
      },
      {
       "default_value": null,
       "help": "Start Y in screenshot pixels",
       "hidden": false,
       "is_optional": false,
       "name": "Y1",
       "possible_values": [],
       "repeatable": false,
       "type": "integer"
      },
      {
       "default_value": null,
       "help": "End X in screenshot pixels",
       "hidden": false,
       "is_optional": false,
       "name": "X2",
       "possible_values": [],
       "repeatable": false,
       "type": "integer"
      },
      {
       "default_value": null,
       "help": "End Y in screenshot pixels",
       "hidden": false,
       "is_optional": false,
       "name": "Y2",
       "possible_values": [],
       "repeatable": false,
       "type": "integer"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "drag",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do drag [OPTIONS] <X1> <Y1> <X2> <Y2>"
    },
    {
     "abstract": "Run a shell command, or open an interactive terminal (PTY) when no command is given on a terminal",
     "after_help": "Examples:\n  cua do shell ls -la /tmp\n  # An interactive terminal\n  cua do shell",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Command and arguments",
       "hidden": false,
       "is_optional": true,
       "name": "COMMAND",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "shell",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Terminal width (default: this terminal's)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cols",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "COLS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Terminal height (default: this terminal's)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "rows",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "ROWS"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do shell [OPTIONS] [COMMAND]..."
    },
    {
     "abstract": "Open a file or URL",
     "after_help": "Examples:\n  cua do open https://example.com",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "File path or URL in the target",
       "hidden": false,
       "is_optional": false,
       "name": "PATH",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "open",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do open [OPTIONS] <PATH>"
    },
    {
     "abstract": "Launch an application",
     "after_help": "Examples:\n  cua do launch firefox\n  cua do launch firefox --private-window",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Application name or path",
       "hidden": false,
       "is_optional": false,
       "name": "APP",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Arguments passed to the application",
       "hidden": false,
       "is_optional": true,
       "name": "ARGS",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "launch",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do launch [OPTIONS] <APP> [ARGS]..."
    },
    {
     "abstract": "Window management",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "window",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [
      {
       "abstract": "List windows (optionally filtered by app or title)",
       "after_help": "Examples:\n  cua do window ls\n  cua do window ls firefox",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Only windows whose app or title contains this",
         "hidden": false,
         "is_optional": true,
         "name": "APP",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "ls",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua do window ls [OPTIONS] [APP]"
      },
      {
       "abstract": "Remove focus from the current window (presses Escape)",
       "after_help": "Examples:\n  cua do window unfocus",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "unfocus",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua do window unfocus [OPTIONS]"
      },
      {
       "abstract": "Focus a window",
       "after_help": "Examples:\n  cua do window focus <window-id>",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Window id (from `cua do window ls`)",
         "hidden": false,
         "is_optional": false,
         "name": "WINDOW_ID",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [
        "activate"
       ],
       "name": "focus",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua do window focus [OPTIONS] <WINDOW_ID>"
      },
      {
       "abstract": "Minimize a window",
       "after_help": "Examples:\n  cua do window minimize <window-id>",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Window id (from `cua do window ls`)",
         "hidden": false,
         "is_optional": false,
         "name": "WINDOW_ID",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "minimize",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua do window minimize [OPTIONS] <WINDOW_ID>"
      },
      {
       "abstract": "Maximize a window",
       "after_help": "Examples:\n  cua do window maximize <window-id>",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Window id (from `cua do window ls`)",
         "hidden": false,
         "is_optional": false,
         "name": "WINDOW_ID",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "maximize",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua do window maximize [OPTIONS] <WINDOW_ID>"
      },
      {
       "abstract": "Restore a minimized or maximized window",
       "after_help": "Examples:\n  cua do window restore <window-id>",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Window id (from `cua do window ls`)",
         "hidden": false,
         "is_optional": false,
         "name": "WINDOW_ID",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "restore",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua do window restore [OPTIONS] <WINDOW_ID>"
      },
      {
       "abstract": "Close a window",
       "after_help": "Examples:\n  cua do window close <window-id>",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Window id (from `cua do window ls`)",
         "hidden": false,
         "is_optional": false,
         "name": "WINDOW_ID",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "close",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua do window close [OPTIONS] <WINDOW_ID>"
      },
      {
       "abstract": "Resize a window",
       "after_help": "Examples:\n  cua do window resize <window-id> 1280 800",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Window id (from `cua do window ls`)",
         "hidden": false,
         "is_optional": false,
         "name": "WINDOW_ID",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        },
        {
         "default_value": null,
         "help": "Width in screen points",
         "hidden": false,
         "is_optional": false,
         "name": "WIDTH",
         "possible_values": [],
         "repeatable": false,
         "type": "integer"
        },
        {
         "default_value": null,
         "help": "Height in screen points",
         "hidden": false,
         "is_optional": false,
         "name": "HEIGHT",
         "possible_values": [],
         "repeatable": false,
         "type": "integer"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "resize",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua do window resize [OPTIONS] <WINDOW_ID> <WIDTH> <HEIGHT>"
      },
      {
       "abstract": "Move a window",
       "after_help": "Examples:\n  cua do window move <window-id> 0 0",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Window id (from `cua do window ls`)",
         "hidden": false,
         "is_optional": false,
         "name": "WINDOW_ID",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        },
        {
         "default_value": null,
         "help": "Left edge in screen points",
         "hidden": false,
         "is_optional": false,
         "name": "X",
         "possible_values": [],
         "repeatable": false,
         "type": "integer"
        },
        {
         "default_value": null,
         "help": "Top edge in screen points",
         "hidden": false,
         "is_optional": false,
         "name": "Y",
         "possible_values": [],
         "repeatable": false,
         "type": "integer"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "move",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua do window move [OPTIONS] <WINDOW_ID> <X> <Y>"
      },
      {
       "abstract": "Show a window as JSON",
       "after_help": "Examples:\n  cua do window info <window-id>",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Window id (from `cua do window ls`)",
         "hidden": false,
         "is_optional": false,
         "name": "WINDOW_ID",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "info",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua do window info [OPTIONS] <WINDOW_ID>"
      }
     ],
     "usage": "cua do window [OPTIONS] <COMMAND>"
    },
    {
     "abstract": "Accessibility tree and actions",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "a11y",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [
      {
       "abstract": "Print the accessibility tree (JSON)",
       "after_help": "Examples:\n  cua do a11y tree\n  cua do a11y tree --window <window-id> --depth 4",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "tree",
       "options": [
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Only this window (default: the focused one)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "window",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "WINDOW"
        },
        {
         "aliases": [],
         "default_value": "0",
         "env": null,
         "help": "Maximum depth (0: unlimited)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "depth",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "integer",
         "value_name": "DEPTH"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua do a11y tree [OPTIONS]"
      },
      {
       "abstract": "Find elements by name (and role)",
       "after_help": "Examples:\n  cua do a11y find Save --role button",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Element name (substring)",
         "hidden": false,
         "is_optional": false,
         "name": "NAME",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "find",
       "options": [
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Only elements with this role",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "role",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "ROLE"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Only this window (default: the focused one)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "window",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "WINDOW"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua do a11y find [OPTIONS] <NAME>"
      },
      {
       "abstract": "Act on an element: press, focus, set-value, increment, ...",
       "after_help": "Examples:\n  cua do a11y act <element-id>\n  cua do a11y act <element-id> set-value 'hello'",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Element id from `tree` or `find`",
         "hidden": false,
         "is_optional": false,
         "name": "ELEMENT",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        },
        {
         "default_value": "press",
         "help": "Action",
         "hidden": false,
         "is_optional": true,
         "name": "ACTION",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        },
        {
         "default_value": null,
         "help": "Value for `set-value`",
         "hidden": false,
         "is_optional": true,
         "name": "VALUE",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "act",
       "options": [
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Snapshot id from `tree`/`find` (default: the latest)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "snapshot",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "SNAPSHOT"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua do a11y act [OPTIONS] <ELEMENT> [ACTION] [VALUE]"
      }
     ],
     "usage": "cua do a11y [OPTIONS] <COMMAND>"
    },
    {
     "abstract": "Print the cursor position (screen points)",
     "after_help": "Examples:\n  cua do cursor",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "cursor",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua do cursor [OPTIONS]"
    },
    {
     "abstract": "Clipboard text",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "clipboard",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [
      {
       "abstract": "Print clipboard text",
       "after_help": "Examples:\n  cua do clipboard get",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "get",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua do clipboard get [OPTIONS]"
      },
      {
       "abstract": "Set clipboard text",
       "after_help": "Examples:\n  cua do clipboard set 'hello'",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Text to put on the clipboard",
         "hidden": false,
         "is_optional": false,
         "name": "TEXT",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "set",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua do clipboard set [OPTIONS] <TEXT>"
      }
     ],
     "usage": "cua do clipboard [OPTIONS] <COMMAND>"
    }
   ],
   "usage": "cua do [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Grant consent for `cua do switch host`",
   "after_help": "Examples:\n  # Allow `cua do` to act on this computer's desktop\n  cua do-host-consent",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "do-host-consent",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [],
   "usage": "cua do-host-consent [OPTIONS]"
  },
  {
   "abstract": "Stdio MCP server exposing sandboxes, computer control and skills",
   "after_help": "Examples:\n  # Serve every tool over stdio (what MCP clients launch)\n  cua mcp\n  # Read-only sandbox tools, computer tools on the sandbox dev\n  cua mcp --permissions sandbox:readonly,computer:all --sandbox dev\n  # An agent that joined a Space with cua join: its thread tools only\n  cua mcp --member ubuntu-build/codex",
   "aliases": [
    "serve-mcp"
   ],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "mcp",
   "options": [
    {
     "aliases": [],
     "default_value": null,
     "env": "CUA_MCP_PERMISSIONS",
     "help": "Comma-separated permissions or groups (default: all)",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "permissions",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "PERMISSIONS"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": "CUA_SANDBOX",
     "help": "Default sandbox for computer tools",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "sandbox",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "SANDBOX"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Serve only the Space thread tools (thread_join, thread_inbox, thread_read, thread_post, agent_members) as the agent this computer joined with `cua join` (`<space>/<handle>`). Its key stays in the keychain",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "member",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "MEMBER"
    }
   ],
   "subcommand_optional": false,
   "subcommands": [],
   "usage": "cua mcp [OPTIONS]"
  },
  {
   "abstract": "Join a Space as an agent on this computer, with the code from a \"Join my Cua Space\" link. Needs your Cua sign-in; the code works once",
   "after_help": "Exit codes: 0 joined (or waiting to be let in), 3 not signed in, 4 the code does not work, 5 too many wrong codes, 1 anything else.\n\nExamples:\n  cua join 7KQ2-9FXA\n  cua join https://cua.ai/join/7KQ2-9FXA",
   "aliases": [],
   "arguments": [
    {
     "default_value": null,
     "help": "The join code (`7KQ2-9FXA`) or the link that ends in it",
     "hidden": false,
     "is_optional": false,
     "name": "CODE",
     "possible_values": [],
     "repeatable": false,
     "type": "string"
    }
   ],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "join",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [],
   "usage": "cua join [OPTIONS] <CODE>"
  },
  {
   "abstract": "A Space's thread, as the agent this computer joined with `cua join`: say who you are, read your inbox, post",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "thread",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Say who you are: your name, icon, harness and version",
     "after_help": "Examples:\n  cua thread join --name Codex --harness codex --version 0.61.0 --icon harness",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "join",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The name people see (1-32 characters)",
       "hidden": false,
       "is_optional": false,
       "multiple_values": false,
       "name": "name",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "hermes, claude-code, codex, cursor, openclaw, t3code or other",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "harness",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "HARNESS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Your harness's version",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "version",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "VERSION"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "`harness` (your harness's mark) or an https:// image URL",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "icon",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ICON"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "`<space>/<handle>`, when this computer joined more than one Space",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "member",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MEMBER"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua thread join [OPTIONS] --name <NAME>"
    },
    {
     "abstract": "Your open tasks (@mentions); waits for one up to --wait seconds",
     "after_help": "Examples:\n  cua thread inbox --wait 25",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "inbox",
     "options": [
      {
       "aliases": [],
       "default_value": "0",
       "env": null,
       "help": "Seconds to wait for a task when there is none (at most 25)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "wait",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "WAIT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "member",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MEMBER"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua thread inbox [OPTIONS]"
    },
    {
     "abstract": "Post to the thread, or reply to a task",
     "after_help": "Examples:\n  cua thread post \"Hi, I'm Codex.\"\n  cua thread post --reply-to 19 \"All green.\"\n  cua thread post --window w42 --app Firefox --title \"Pull requests\" \"Is this the right PR?\"",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "TEXT",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "You are looking at the Space's desktop",
       "hidden": false,
       "name": "desktop",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "post",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The task (or entry) this answers",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "reply-to",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "REPLY_TO"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "member",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MEMBER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "What you are looking at in the Space: a window, by its id (as `computer_window_list` gives it). Stored with the post as `view`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "window",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ID"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "That window's app (\"Firefox\")",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "app",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "That window's title",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "title",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TITLE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua thread post [OPTIONS] <TEXT>"
    },
    {
     "abstract": "Read the newest entries",
     "after_help": "Examples:\n  cua thread read\n  cua thread read --after 40 --limit 10",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "read",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Entries after this seq",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "after",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "AFTER"
      },
      {
       "aliases": [],
       "default_value": "30",
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "limit",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "LIMIT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "member",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MEMBER"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua thread read [OPTIONS]"
    }
   ],
   "usage": "cua thread [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Recorded demonstrations (skills) for agents",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "skills",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "List saved skills",
     "after_help": "Examples:\n  cua skills list",
     "aliases": [
      "ls"
     ],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "list",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua skills list [OPTIONS]"
    },
    {
     "abstract": "Print a skill",
     "after_help": "Examples:\n  cua skills read export-invoice\n  cua skills read export-invoice --format json",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Skill name",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "read",
     "options": [
      {
       "aliases": [],
       "default_value": "md",
       "env": null,
       "help": "Output format",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "format",
       "possible_values": [
        "md",
        "json"
       ],
       "repeatable": false,
       "short_name": "f",
       "takes_value": true,
       "type": "md | json",
       "value_name": "FORMAT"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua skills read [OPTIONS] <NAME>"
    },
    {
     "abstract": "Open a skill's video recording",
     "after_help": "Examples:\n  cua skills replay export-invoice",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Skill name",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "replay",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua skills replay [OPTIONS] <NAME>"
    },
    {
     "abstract": "Delete a skill",
     "after_help": "Examples:\n  cua skills delete export-invoice",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Skill name",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "delete",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua skills delete [OPTIONS] <NAME>"
    },
    {
     "abstract": "Delete every skill (asks first)",
     "after_help": "Examples:\n  cua skills clean\n  # Without the prompt\n  cua skills clean --yes",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not ask for confirmation",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": "y",
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "clean",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua skills clean [OPTIONS]"
    },
    {
     "abstract": "Record a demonstration in the HTML5 viewer (it records the screen and your input)",
     "after_help": "Examples:\n  # Record on the sandbox dev and caption with Anthropic\n  cua skills record --sandbox dev --name export-invoice",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "record",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Sandbox whose display service to record",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "sandbox",
       "possible_values": [],
       "repeatable": false,
       "short_name": "s",
       "takes_value": true,
       "type": "string",
       "value_name": "SANDBOX"
      },
      {
       "aliases": [
        "vnc-url"
       ],
       "default_value": null,
       "env": null,
       "help": "Viewer URL to record (a `cua sb view --no-open` link)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "viewer-url",
       "possible_values": [],
       "repeatable": false,
       "short_name": "u",
       "takes_value": true,
       "type": "string",
       "value_name": "VIEWER_URL"
      },
      {
       "aliases": [],
       "default_value": "anthropic",
       "env": null,
       "help": "Captioning provider",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "provider",
       "possible_values": [
        "anthropic",
        "openai"
       ],
       "repeatable": false,
       "short_name": "p",
       "takes_value": true,
       "type": "anthropic | openai",
       "value_name": "PROVIDER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Captioning model",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "model",
       "possible_values": [],
       "repeatable": false,
       "short_name": "m",
       "takes_value": true,
       "type": "string",
       "value_name": "MODEL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "API key for the captioning provider",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "api-key",
       "possible_values": [],
       "repeatable": false,
       "short_name": "k",
       "takes_value": true,
       "type": "string",
       "value_name": "API_KEY"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Skill name",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "name",
       "possible_values": [],
       "repeatable": false,
       "short_name": "n",
       "takes_value": true,
       "type": "string",
       "value_name": "NAME"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Skill description",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "description",
       "possible_values": [],
       "repeatable": false,
       "short_name": "d",
       "takes_value": true,
       "type": "string",
       "value_name": "DESCRIPTION"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua skills record [OPTIONS]"
    }
   ],
   "usage": "cua skills [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Recorded `cua do` trajectories",
   "aliases": [
    "traj"
   ],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "trajectory",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "List sessions",
     "after_help": "Examples:\n  cua traj ls\n  # Only the sessions recorded on the sandbox dev\n  cua traj ls dev",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Only sessions of this target (sandbox name or `host`)",
       "hidden": false,
       "is_optional": true,
       "name": "TARGET",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "ls",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua trajectory ls [OPTIONS] [TARGET]"
    },
    {
     "abstract": "Zip, serve on loopback and open the hosted viewer",
     "after_help": "Examples:\n  # The latest session\n  cua traj view\n  cua traj view <session> --port 8090",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Session id or target name (default: the latest session)",
       "hidden": false,
       "is_optional": true,
       "name": "TARGET",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "view",
     "options": [
      {
       "aliases": [],
       "default_value": "8089",
       "env": null,
       "help": "Loopback port of the file server",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "port",
       "possible_values": [],
       "repeatable": false,
       "short_name": "p",
       "takes_value": true,
       "type": "integer",
       "value_name": "PORT"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua trajectory view [OPTIONS] [TARGET]"
    },
    {
     "abstract": "Stop the file server started by `view`",
     "after_help": "Examples:\n  cua traj stop",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "stop",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua trajectory stop [OPTIONS]"
    },
    {
     "abstract": "Delete sessions",
     "after_help": "Examples:\n  # Sessions older than a week, without the prompt\n  cua traj clean --older-than 7 --yes",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not ask for confirmation",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": "y",
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "clean",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only sessions older than this many days",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "older-than",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "DAYS"
      },
      {
       "aliases": [
        "computer"
       ],
       "default_value": null,
       "env": null,
       "help": "Only sessions of this target",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "machine",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "COMPUTER"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua trajectory clean [OPTIONS]"
    },
    {
     "abstract": "(internal) Serve a directory for the viewer",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "DIR",
       "possible_values": [],
       "repeatable": false,
       "type": "path"
      }
     ],
     "flags": [],
     "hidden": true,
     "hidden_aliases": [],
     "name": "serve",
     "options": [
      {
       "aliases": [],
       "default_value": "8089",
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "port",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "PORT"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua trajectory serve [OPTIONS] <DIR>"
    }
   ],
   "usage": "cua trajectory [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Removed: Cua Cloud has ended",
   "aliases": [],
   "arguments": [
    {
     "default_value": null,
     "help": "",
     "hidden": false,
     "is_optional": true,
     "name": "ARGS",
     "possible_values": [],
     "repeatable": true,
     "type": "string"
    }
   ],
   "flags": [],
   "hidden": true,
   "hidden_aliases": [],
   "name": "wif-token",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [],
   "usage": "cua wif-token [OPTIONS] [ARGS]..."
  },
  {
   "abstract": "Removed: Cua Cloud has ended",
   "aliases": [],
   "arguments": [
    {
     "default_value": null,
     "help": "",
     "hidden": false,
     "is_optional": true,
     "name": "ARGS",
     "possible_values": [],
     "repeatable": true,
     "type": "string"
    }
   ],
   "flags": [],
   "hidden": true,
   "hidden_aliases": [],
   "name": "fleet",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [],
   "usage": "cua fleet [OPTIONS] [ARGS]..."
  },
  {
   "abstract": "Removed: Cua Cloud has ended",
   "aliases": [],
   "arguments": [
    {
     "default_value": null,
     "help": "",
     "hidden": false,
     "is_optional": true,
     "name": "ARGS",
     "possible_values": [],
     "repeatable": true,
     "type": "string"
    }
   ],
   "flags": [],
   "hidden": true,
   "hidden_aliases": [],
   "name": "pools",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [],
   "usage": "cua pools [OPTIONS] [ARGS]..."
  },
  {
   "abstract": "Build an image from a Dockerfile, in a Space, as pinned checkpoints that Spaces fork from in under a second. Works in any directory; layers already built are reused",
   "after_help": "Examples:\n  # Build ./Dockerfile with ./ as the context\n  cua build -t app\n  # Another directory and Dockerfile; build arguments\n  cua build -f docker/Dockerfile.dev --build-arg PY=3.12 -t app-dev ./services/api\n  # A Dockerfile piped in on stdin, a bigger machine, every layer again\n  cua build -f - --cpus 4 --memory 8192 --no-cache -t app\n  # Run it\n  cua spaces create build:app\n  cua sb fork build-<key> mybox",
   "aliases": [],
   "arguments": [
    {
     "default_value": ".",
     "help": "The build context: `COPY` and `ADD` sources are relative to it, and its `.dockerignore` applies",
     "hidden": false,
     "is_optional": true,
     "name": "CONTEXT",
     "possible_values": [],
     "repeatable": false,
     "type": "path"
    }
   ],
   "flags": [
    {
     "aliases": [],
     "default_value": false,
     "env": null,
     "help": "Keep the desktop (the build's machine is headless by default: only cua-spacesd runs)",
     "hidden": false,
     "name": "desktop",
     "repeatable": false,
     "short_name": null,
     "takes_value": false
    },
    {
     "aliases": [],
     "default_value": false,
     "env": null,
     "help": "Build every layer again",
     "hidden": false,
     "name": "no-cache",
     "repeatable": false,
     "short_name": null,
     "takes_value": false
    }
   ],
   "hidden": false,
   "hidden_aliases": [],
   "name": "build",
   "options": [
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "The Dockerfile (`-`: standard input). Default: `Dockerfile` in the context",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "file",
     "possible_values": [],
     "repeatable": false,
     "short_name": "f",
     "takes_value": true,
     "type": "string",
     "value_name": "FILE"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Name the result: `build:<tag>` is an image for `cua spaces create`, and `cua sb fork` finds it",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "tag",
     "possible_values": [],
     "repeatable": false,
     "short_name": "t",
     "takes_value": true,
     "type": "string",
     "value_name": "TAG"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "`NAME=VALUE` for an `ARG` (repeatable)",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "build-arg",
     "possible_values": [],
     "repeatable": true,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "BUILD_ARG"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "`vm` (default), `container` or `microvm`",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "kind",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "KIND"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Where: `local` (default). A build's layers are checkpoints, which stay on the machine that took them",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "on",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "ON"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "vCPUs of the machine (and of Spaces made from the build; default 2)",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "cpus",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "integer",
     "value_name": "CPUS"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Memory in MiB (default 4096)",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "memory",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "integer",
     "value_name": "MEMORY_MB"
    },
    {
     "aliases": [],
     "default_value": "1h",
     "env": null,
     "help": "Budget for each step",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "step-timeout",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "STEP_TIMEOUT"
    }
   ],
   "subcommand_optional": false,
   "subcommands": [],
   "usage": "cua build [OPTIONS] [CONTEXT]"
  },
  {
   "abstract": "What a Space can reach on the network, and changing it: `show`, `set`, `log`. An experiment: see `cua experiments`",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "network",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "What a Space can reach: its preset, what it opens, where it is enforced, and what is always blocked",
     "after_help": "Examples:\n  cua network show studio\n  cua network show local:studio --json",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id or name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "show",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua network show [OPTIONS] <SPACE>"
    },
    {
     "abstract": "Change what a Space can reach. A child Space stays within its parent's unless `--widen`",
     "after_help": "Examples:\n  # This computer's Postgres and dev server only\n  cua network set studio --network localhost:5432,3000\n  # Your local network too\n  cua network set studio --network lan\n  # Only these destinations\n  cua network set studio --network custom:none --allow 140.82.112.0/20\n  # Back to the default\n  cua network set studio --network internet\n  # Its internet traffic leaves through this computer (the hotspot)\n  cua network set studio --via this-computer\n  # ... or through another Space of its tree, or a SOCKS5 proxy\n  cua network set worker --via space:gateway\n  cua network set studio --via socks5://proxy.example:1080\n  # Its own network again\n  cua network set studio --via internet",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id or name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "A child Space: let it reach more than its parent (recorded on the Space)",
       "hidden": false,
       "name": "widen",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Its child Spaces get the same settings (each within its parent's)",
       "hidden": false,
       "name": "tree",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "set",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "`internet`, `none`, `localhost:<ports>` (or `localhost:all`), `lan`, `localhost+lan:<ports>` (both), `custom`, `custom:none` or `unprotected` (No protection). Left out: the preset it has (to change only `--via`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "network",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PRESET"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Where its internet traffic leaves: `internet` (its own network, the default), `this-computer` (this computer's network: the hotspot), `space:<name>` (a Space of its tree) or `socks5://host:port`. Its rules apply first; if the exit goes away, its internet stops (it never falls back). A child keeps its parent's. Left out: the exit it has",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "via",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "EXIT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Allow this destination (IP, CIDR, or a name such as `pypi.org` or `*.github.com` on runtimes behind the Cua network gateway; repeat for more)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "allow",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ADDR|CIDR"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Block this destination (IP, CIDR, `all`, or a name on runtimes behind the Cua network gateway; repeat for more). A deny wins over the Space's own tree: it blocks a member of the tree too",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "deny",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ADDR|CIDR|all"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua network set [OPTIONS] <SPACE>"
    },
    {
     "abstract": "What a Space tried to reach and was blocked, most recent first",
     "after_help": "Examples:\n  cua network log studio",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id or name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "log",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua network log [OPTIONS] <SPACE>"
    }
   ],
   "usage": "cua network [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Send a Space's internet traffic out through this computer for a while: `start`, `stop`, `status`. (`cua network set --via this-computer` keeps it.) Part of the Secure Spaces experiment",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "hotspot",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Send a Space's internet traffic out through this computer's network until `cua hotspot stop` (its own rules still apply)",
     "after_help": "Examples:\n  cua hotspot start studio\n  cua hotspot start studio --system-proxy --bypass 10.0.0.0/8",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id or name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Point the Space's system proxy (and new processes' ALL_PROXY) at it. Otherwise apps use the SOCKS address it prints",
       "hidden": false,
       "name": "system-proxy",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "start",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Destinations that keep the Space's own network (repeat)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "bypass",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ADDR|CIDR|NAME"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua hotspot start [OPTIONS] <SPACE>"
    },
    {
     "abstract": "Stop it",
     "after_help": "Examples:\n  cua hotspot stop studio",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id or name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "stop",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua hotspot stop [OPTIONS] <SPACE>"
    },
    {
     "abstract": "Whether it is on, and what it carried",
     "after_help": "Examples:\n  cua hotspot status studio --json",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id or name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "status",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua hotspot status [OPTIONS] <SPACE>"
    }
   ],
   "usage": "cua hotspot [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "How traffic reaches your other computers: `status` (and `--prefer`). Part of the Secure Spaces experiment",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "mesh",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "The path to each other computer (local network, direct or relay), its round trip and why it was chosen. `--prefer` pins it",
     "after_help": "Examples:\n  cua mesh status\n  cua mesh status --prefer lan\n  cua mesh status --prefer auto",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "status",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Pin the path: `lan` (the local network whenever it answers), `direct`, `relay`, or `auto` (fastest; lifts the pin). Traffic never stops: a pinned path that goes away falls back",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "prefer",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "lan|direct|relay|auto"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua mesh status [OPTIONS]"
    }
   ],
   "usage": "cua mesh [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Features that are still being built, one switch each: `list`, `enable`, `disable`",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "experiments",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Every experiment and whether it is on",
     "after_help": "Examples:\n  cua experiments list\n  cua experiments list --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "list",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua experiments list [OPTIONS]"
    },
    {
     "abstract": "Turn an experiment on",
     "after_help": "Examples:\n  cua experiments enable secure-spaces",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The experiment's name, as `cua experiments` lists it",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "enable",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua experiments enable [OPTIONS] <NAME>"
    },
    {
     "abstract": "Turn an experiment off. Nothing it made is deleted",
     "after_help": "Examples:\n  cua experiments disable secure-spaces",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The experiment's name, as `cua experiments` lists it",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "disable",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua experiments disable [OPTIONS] <NAME>"
    }
   ],
   "usage": "cua experiments [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Images: local OCI pull/build/push",
   "aliases": [
    "img"
   ],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "image",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Pull an image into the local cache",
     "after_help": "Examples:\n  cua image pull linux\n  cua image pull ghcr.io/trycua/linux:24.04",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Image reference or alias",
       "hidden": false,
       "is_optional": false,
       "name": "REFERENCE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "pull",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua image pull [OPTIONS] <REFERENCE>"
    },
    {
     "abstract": "Build an image from an images.cua.ai/v1alpha1 Image resource (JSON)",
     "after_help": "Examples:\n  cua image build image.json --base container:ubuntu:24.04\n  cua image build image.json --base container:ubuntu:24.04 --push ghcr.io/acme/desktop:1",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Image resource file (JSON)",
       "hidden": false,
       "is_optional": false,
       "name": "SPEC",
       "possible_values": [],
       "repeatable": false,
       "type": "path"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "build",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Base image (`container:<ref>`, `vm:<ref>`, `disk:<path>`)",
       "hidden": false,
       "is_optional": false,
       "multiple_values": false,
       "name": "base",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "BASE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Push the result to this reference",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "push",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PUSH"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua image build [OPTIONS] --base <BASE> <SPEC>"
    },
    {
     "abstract": "Copy an image (host architecture) to another registry reference",
     "after_help": "Examples:\n  cua image push linux ghcr.io/acme/desktop:1",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Source image reference or alias",
       "hidden": false,
       "is_optional": false,
       "name": "REFERENCE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Destination registry reference",
       "hidden": false,
       "is_optional": false,
       "name": "DESTINATION",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "push",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua image push [OPTIONS] <REFERENCE> <DESTINATION>"
    },
    {
     "abstract": "Removed: Cua Cloud has ended",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "name": "ARGS",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": true,
     "hidden_aliases": [
      "list"
     ],
     "name": "ls",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua image ls [OPTIONS] [ARGS]..."
    },
    {
     "abstract": "Removed: Cua Cloud has ended",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "name": "ARGS",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": true,
     "hidden_aliases": [],
     "name": "info",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua image info [OPTIONS] [ARGS]..."
    },
    {
     "abstract": "Removed: Cua Cloud has ended",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "name": "ARGS",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": true,
     "hidden_aliases": [
      "delete"
     ],
     "name": "rm",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua image rm [OPTIONS] [ARGS]..."
    },
    {
     "abstract": "Removed: Cua Cloud has ended",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "name": "ARGS",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": true,
     "hidden_aliases": [],
     "name": "create",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua image create [OPTIONS] [ARGS]..."
    }
   ],
   "usage": "cua image [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "The sandbox image catalog (the images the docs list): which exist, their variants, and which ship cua-spacesd and a browser",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "images",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "List the catalog: ref, OS, container or VM, local runtime, cua-spacesd, browsers, summary",
     "after_help": "Examples:\n  cua images ls\n  # Images whose browser the cua-driver browser tools drive\n  cua images ls --browser\n  cua images ls --all --json",
     "aliases": [
      "list"
     ],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Include unpublished entries (benchmark images)",
       "hidden": false,
       "name": "all",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Only images with a browser the cua-driver browser tools drive",
       "hidden": false,
       "name": "browser",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "ls",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only this OS: linux, windows or macos",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "os",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "OS"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua images ls [OPTIONS]"
    },
    {
     "abstract": "Show one catalog entry (a ref or an alias such as `linux`)",
     "after_help": "Examples:\n  cua images info linux",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Image ref or alias",
       "hidden": false,
       "is_optional": false,
       "name": "REFERENCE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "info",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua images info [OPTIONS] <REFERENCE>"
    },
    {
     "abstract": "Build a sandbox image definition (a libs/images directory): the rootfs, the bootable VM disk and the KubeVirt containerDisk",
     "after_help": "Outputs: rootfs <repo>:docker-<tag>-<arch>; disk <out>/<name>/<arch>/disk.img;\ncontainerdisk <repo>:<tag>-<arch>. --push pushes the outputs the image.json\nlists (a VM-only image never pushes its rootfs).\n\nExamples:\n  cua images build libs/images/omarchy --outputs rootfs,disk\n  cua images build libs/images/omarchy --tag build-1a2b3c4d --outputs containerdisk --push\n  cua images build libs/images/linux --target slim --tag 24.04-slim-local --outputs rootfs,disk\n  cua images build libs/images/linux --platform linux/amd64,linux/arm64 --dry-run",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Image definition directory (Dockerfile, image.json)",
       "hidden": false,
       "is_optional": false,
       "name": "DIR",
       "possible_values": [],
       "repeatable": false,
       "type": "path"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Push the published outputs",
       "hidden": false,
       "name": "push",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Print the steps without running them",
       "hidden": false,
       "name": "dry-run",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "build",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Platforms, comma separated (default: the host's, or the image's only one)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "platform",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PLATFORM"
      },
      {
       "aliases": [],
       "default_value": "local",
       "env": null,
       "help": "Tag for the per-arch outputs",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "tag",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TAG"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Repository (default: image.json `repository`, else cua-e2e-local/<name>)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "repo",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REPO"
      },
      {
       "aliases": [],
       "default_value": "rootfs",
       "env": null,
       "help": "Outputs: rootfs, disk, containerdisk (comma separated)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "outputs",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "OUTPUTS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Docker build argument KEY=VALUE (repeatable)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "build-arg",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "BUILD_ARGS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Named build context NAME=PATH (repeatable)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "build-context",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "BUILD_CONTEXTS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Extra rootfs label KEY=VALUE (repeatable)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "label",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "LABELS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Where disks go (default: $CUA_IMAGES_OUT or ~/.cache/cua-images)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "out",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "path",
       "value_name": "OUT"
      },
      {
       "aliases": [],
       "default_value": "20G",
       "env": null,
       "help": "Virtual size of the disk",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "disk-size",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "DISK_SIZE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Dockerfile stage to build (a tier: `slim`, `full`); disks go to <out>/<name>-<target>/<arch>. Default: the Dockerfile's last stage",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "target",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TARGET"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua images build [OPTIONS] <DIR>"
    },
    {
     "abstract": "Pack the disks `cua images build --outputs disk` wrote as KubeVirt containerDisks `<repo>:<tag>-<arch>` (push, or load into docker)",
     "after_help": "Packs exactly the disk the doctor checked, so the pushed bytes are the\ntested ones.\n\nExamples:\n  cua images pack libs/images/omarchy --tag ci-1a2b3c4d --push --json",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Image definition directory",
       "hidden": false,
       "is_optional": false,
       "name": "DIR",
       "possible_values": [],
       "repeatable": false,
       "type": "path"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Push instead of loading into docker",
       "hidden": false,
       "name": "push",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Print what would be packed",
       "hidden": false,
       "name": "dry-run",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "pack",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Platforms, comma separated (default: the host's, or the image's only one)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "platform",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PLATFORM"
      },
      {
       "aliases": [],
       "default_value": "local",
       "env": null,
       "help": "Tag for the per-arch containerDisks",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "tag",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TAG"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Repository (default: image.json `repository`, else cua-e2e-local/<name>)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "repo",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REPO"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Where the disks are (default: $CUA_IMAGES_OUT or ~/.cache/cua-images)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "out",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "path",
       "value_name": "OUT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The `--target` the disks were built with (their <name>-<target> dir)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "target",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TARGET"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua images pack [OPTIONS] <DIR>"
    },
    {
     "abstract": "Publish a built image as immutable pins `<series>-<stamp>` and `<series>-disk-<stamp>`, refusing any that exist. Moves nothing",
     "after_help": "Reads the per-arch images `cua images build --tag TAG --push` wrote\n(<repo>:<tag>-<arch>, and <repo>:docker-<tag>-<arch> when the image has a rootfs\noutput). Writes the record `cua images promote` takes.\n\nExamples:\n  cua images publish libs/images/omarchy --tag build-1a2b3c4d --series edge --record pins.json\n  cua images publish libs/images/linux --tag build-20260925-1a2b3c4 --series 24.04 --descriptor-annotation rootfs/amd64:ai.cua.doctor.status=pass\n  cua images publish libs/images/omarchy --tag build-1a2b3c4d --series edge --dry-run",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Image definition directory",
       "hidden": false,
       "is_optional": false,
       "name": "DIR",
       "possible_values": [],
       "repeatable": false,
       "type": "path"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Resolve and print, push nothing",
       "hidden": false,
       "name": "dry-run",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "publish",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The build tag the per-arch images were pushed under",
       "hidden": false,
       "is_optional": false,
       "multiple_values": false,
       "name": "tag",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TAG"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Series / channel (`edge`, `24.04`)",
       "hidden": false,
       "is_optional": false,
       "multiple_values": false,
       "name": "series",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SERIES"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Pin stamp `<yyyymmdd>-<sha7>` (default: today and git HEAD)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "stamp",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "STAMP"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Repository (default: image.json `repository`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "repo",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REPO"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Platforms (default: image.json `platforms`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "platform",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PLATFORM"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Extra index annotation KEY=VALUE (repeatable)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "annotation",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ANNOTATIONS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Annotation on one child's descriptor, VARIANT/ARCH:KEY=VALUE (`rootfs/amd64:ai.cua.doctor.status=pass`; repeatable)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "descriptor-annotation",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "DESCRIPTOR_ANNOTATIONS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Write the publish record (JSON) here",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "record",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "path",
       "value_name": "RECORD"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua images publish [OPTIONS] --tag <TAG> --series <SERIES> <DIR>"
    },
    {
     "abstract": "Run an image's release pipeline (its release.json): build, doctor lanes, content digest, save; with --publish push, publish pins and verify; with --promote move the floating tags. The same command runs locally and in CI",
     "after_help": "Phases: prepare, build, gate (doctor lanes), stage, push, publish, verify,\npromote. Push refuses unless every required gate passed (this run, or a\nstate-*.json merged from other jobs in <work>/evidence). Evidence, logs and\nthe summary go to <work>/evidence (a plain directory CI uploads as-is).\n\nExamples:\n  # Plan only\n  cua images release libs/images/linux --tier slim --dry-run\n  # Build and doctor amd64 locally; resume after a failure\n  cua images release libs/images/linux --tier slim --arch amd64 --resume\n  # Rerun from the doctor lanes (the build must have passed)\n  cua images release libs/images/linux --tier slim --from gate\n  # One CI job's slice\n  cua images release libs/images/linux --tier full --arch arm64 --steps build,gate,stage --work release\n  # Publish and promote (the gates must have passed)\n  cua images release libs/images/omarchy --publish --promote --resume",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Image directory with a release.json",
       "hidden": false,
       "is_optional": false,
       "name": "DIR",
       "possible_values": [],
       "repeatable": false,
       "type": "path"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Skip steps that passed with the same inputs and whose outputs exist",
       "hidden": false,
       "name": "resume",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Print the plan; run nothing",
       "hidden": false,
       "name": "dry-run",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Also push, publish immutable pins and verify them",
       "hidden": false,
       "name": "publish",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Also move the floating tags to the pins",
       "hidden": false,
       "name": "promote",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "release",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Tier (`slim`, `full`) for images that have tiers",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "tier",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TIER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Arches, comma separated (default: release.json `arches`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "arch",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ARCHES"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Pin stamp `<yyyymmdd>-<sha7>` (default: today and git HEAD)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "stamp",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "STAMP"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Work directory (default: $CUA_RELEASE_WORK, else under the cua build cache, which `cua cache prune` manages)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "work",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "path",
       "value_name": "WORK"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only these steps: phase names or step-id prefixes (comma separated)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "steps",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "STEPS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Rerun from this phase or step; the steps before it must have passed",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "from",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "FROM"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Variable KEY=VALUE for release.json templates (repeatable)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "var",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "VARS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Treat a host capability as present (`kvm`) or absent (`!runsc`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "assume",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ASSUME"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "This run's state file name, state-<scope>.json (default: the arches); CI jobs sharing an evidence directory use distinct scopes",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "scope",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SCOPE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua images release [OPTIONS] <DIR>"
    },
    {
     "abstract": "Move a series' moving tags (`edge`, `edge-disk`) to the pins a `cua images publish` record names, after the gates passed",
     "after_help": "Examples:\n  cua images promote pins.json\n  cua images promote pins.json --dry-run",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Record written by `cua images publish --record`",
       "hidden": false,
       "is_optional": false,
       "name": "RECORD",
       "possible_values": [],
       "repeatable": false,
       "type": "path"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Check and print, move nothing",
       "hidden": false,
       "name": "dry-run",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "promote",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua images promote [OPTIONS] <RECORD>"
    }
   ],
   "usage": "cua images [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Talk to a cua-spacesd directly by URL",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "spacesd",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Print capabilities",
     "after_help": "Examples:\n  cua spacesd caps http://127.0.0.1:3211",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "spacesd URL (`http://host:port`)",
       "hidden": false,
       "is_optional": false,
       "name": "URL",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "caps",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": "CUA_ENV_TOKEN",
       "help": "spacesd token",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "token",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TOKEN"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spacesd caps [OPTIONS] <URL>"
    },
    {
     "abstract": "Run a command (argv, no shell)",
     "after_help": "Examples:\n  cua spacesd exec http://127.0.0.1:3211 uname -a\n  # A long-lived stdio stream (stdin forwarded, no time limit, killed with this command)\n  cua spacesd exec -i http://127.0.0.1:3211 cat",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "spacesd URL (`http://host:port`)",
       "hidden": false,
       "is_optional": false,
       "name": "URL",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Program and arguments",
       "hidden": false,
       "is_optional": false,
       "name": "COMMAND",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Stream: run the command as argv (no shell), forward this command's stdin, write stdout and stderr as they arrive, set no time limit, pass SIGINT/SIGTERM/SIGHUP on, and kill the command when this process ends. Exits with the command's status (128 + n for signal n)",
       "hidden": false,
       "name": "stdin",
       "repeatable": false,
       "short_name": "i",
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "exec",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Run as this guest user",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "user",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "USER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Start in this guest directory",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cwd",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "CWD"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Stop the command after this many seconds (0: no limit)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "timeout",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "SECONDS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": "CUA_ENV_TOKEN",
       "help": "spacesd token",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "token",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TOKEN"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spacesd exec [OPTIONS] <URL> <COMMAND>..."
    },
    {
     "abstract": "Copy files: `cua spacesd cp <URL> local :remote` uploads, `cua spacesd cp <URL> :remote local` downloads",
     "after_help": "Examples:\n  # Upload\n  cua spacesd cp http://127.0.0.1:3211 ./notes.txt :/tmp/notes.txt\n  # Download\n  cua spacesd cp http://127.0.0.1:3211 :/tmp/notes.txt ./notes.txt",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "spacesd URL (`http://host:port`)",
       "hidden": false,
       "is_optional": false,
       "name": "URL",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Source: a local path, or `:/guest/path`",
       "hidden": false,
       "is_optional": false,
       "name": "SRC",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Destination: a local path, or `:/guest/path`",
       "hidden": false,
       "is_optional": false,
       "name": "DST",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "cp",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": "CUA_ENV_TOKEN",
       "help": "spacesd token",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "token",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TOKEN"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spacesd cp [OPTIONS] <URL> <SRC> <DST>"
    },
    {
     "abstract": "Interactive shell (PTY)",
     "after_help": "Examples:\n  cua spacesd shell http://127.0.0.1:3211",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "spacesd URL (`http://host:port`)",
       "hidden": false,
       "is_optional": false,
       "name": "URL",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "shell",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": "CUA_ENV_TOKEN",
       "help": "spacesd token",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "token",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TOKEN"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spacesd shell [OPTIONS] <URL>"
    },
    {
     "abstract": "List streamable targets (displays, and windows with --windows)",
     "after_help": "Examples:\n  cua spacesd targets http://127.0.0.1:3211 --windows",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "spacesd URL (`http://host:port`)",
       "hidden": false,
       "is_optional": false,
       "name": "URL",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Include window targets",
       "hidden": false,
       "name": "windows",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "targets",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": "CUA_ENV_TOKEN",
       "help": "spacesd token",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "token",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TOKEN"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spacesd targets [OPTIONS] <URL>"
    },
    {
     "abstract": "Call any cua.env.v1 RPC with a proto3-JSON body",
     "after_help": "Examples:\n  cua spacesd call http://127.0.0.1:3211 SystemService/GetCapabilities",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "spacesd URL (`http://host:port`)",
       "hidden": false,
       "is_optional": false,
       "name": "URL",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "`Service/Method`",
       "hidden": false,
       "is_optional": false,
       "name": "METHOD",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": "{}",
       "help": "Request body (proto3 JSON)",
       "hidden": false,
       "is_optional": true,
       "name": "BODY",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "call",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": "CUA_ENV_TOKEN",
       "help": "spacesd token",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "token",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TOKEN"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spacesd call [OPTIONS] <URL> <METHOD> [BODY]"
    }
   ],
   "usage": "cua spacesd [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "The cua daemon",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "daemon",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Start the daemon (in the background unless --foreground)",
     "after_help": "Examples:\n  cua daemon start\n  # In the foreground, for a service manager\n  cua daemon start --foreground",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Stay in the foreground",
       "hidden": false,
       "name": "foreground",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "start",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Unix socket (default ~/.cua/cua.sock)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "socket",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "path",
       "value_name": "SOCKET"
      },
      {
       "aliases": [],
       "default_value": "127.0.0.1:0",
       "env": null,
       "help": "Loopback address (default 127.0.0.1:0; \"off\" disables)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "loopback",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "LOOPBACK"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua daemon start [OPTIONS]"
    },
    {
     "abstract": "Stop the daemon",
     "after_help": "Examples:\n  cua daemon stop",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "stop",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua daemon stop [OPTIONS]"
    },
    {
     "abstract": "End the VMs nobody uses: a Space whose lifetime passed, a warm-pool member of a daemon that is gone, a VM nothing records or whose home was deleted. Runs without a daemon (a service manager can run it on a timer); a home with a running daemon is left to that daemon",
     "after_help": "Examples:\n  # See what would be ended\n  cua daemon reap --dry-run\n  cua daemon reap",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Only report what would be ended",
       "hidden": false,
       "name": "dry-run",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "reap",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua daemon reap [OPTIONS]"
    },
    {
     "abstract": "Show daemon status",
     "after_help": "Examples:\n  cua daemon status",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "status",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua daemon status [OPTIONS]"
    },
    {
     "abstract": "Stdio MCP server backed by the daemon (started if needed): the Spaces contract tools plus the sandbox/computer/skills tools (same server as `cua mcp`)",
     "after_help": "Examples:\n  cua daemon mcp\n  cua daemon mcp --permissions spaces:all",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "mcp",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": "CUA_MCP_PERMISSIONS",
       "help": "Comma-separated permissions or groups (default: all)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "permissions",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PERMISSIONS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": "CUA_SANDBOX",
       "help": "Default sandbox for computer tools",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "sandbox",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SANDBOX"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua daemon mcp [OPTIONS]"
    }
   ],
   "usage": "cua daemon [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Local runtimes (cua-vmm)",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "runtime",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Inspect local runtimes (read-only). Exit 1 if any check is Error; warnings exit 0",
     "after_help": "Examples:\n  cua runtime doctor",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "doctor",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua runtime doctor [OPTIONS]"
    },
    {
     "abstract": "Provision local runtimes. Exit 1 if any step is Error; warnings exit 0",
     "after_help": "Examples:\n  # See what would be installed\n  cua runtime setup --dry-run\n  cua runtime setup qemu",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Components: `qemu`, `lume`, `runsc` (default: everything provisionable)",
       "hidden": false,
       "is_optional": true,
       "name": "COMPONENTS",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Only report what would be done",
       "hidden": false,
       "name": "dry-run",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "setup",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua runtime setup [OPTIONS] [COMPONENTS]..."
    }
   ],
   "usage": "cua runtime [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Run another provider's SDK unchanged on Cua Spaces: a local gateway that speaks its wire protocol (`cua compat serve --provider e2b`)",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "compat",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Serve a provider's wire protocol from Cua Spaces until stopped",
     "after_help": "Examples:\n  cua compat serve --provider e2b\n  cua compat serve --provider daytona --on host:mac-studio --kind vm\n  cua compat serve --provider modal\n  cua compat serve --provider e2b --overlay cua-spacesd=./target/debug/cua-spacesd",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not make a first sandbox before serving. By default `serve` pulls the image and boots one default sandbox (then deletes it) and only then prints the `Clients export` line, so the first create of a separate client program cannot outlast the SDK's request timeout",
       "hidden": false,
       "name": "no-warm",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not create the default user in images that lack it",
       "hidden": false,
       "name": "no-create-user",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "serve",
     "options": [
      {
       "aliases": [],
       "default_value": "e2b",
       "env": null,
       "help": "Provider whose SDK clients use (`e2b`, `daytona`, `modal`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "provider",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PROVIDER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "API (and envd) listen address. Loopback by default",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "listen",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "LISTEN"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Port of the `<port>-<id>.<domain>` host router (TLS and plain HTTP)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "host-port",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "HOST_PORT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Where new Spaces run (default: the core default, this machine; `auto`: least-loaded machine of your pool; `host:<machine>`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "on",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ON"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Space kind (`vm`: Linux on QEMU/HVF or KVM; `container`; `microvm`). Default: `vm` where this machine can run one, else `container`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "kind",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "KIND"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Image for the provider's base template (default: the canonical Linux image)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "image",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "IMAGE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "vCPUs per Space",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cpus",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "CPUS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Memory per Space (MiB)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "memory-mb",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MEMORY_MB"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Inject a freshly built binary into every new sandbox, `NAME=PATH[:GUEST_PATH]` (as `cua sandbox create --overlay`), for trying a guest agent that no image carries yet. Repeatable",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "overlay",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME=PATH[:GUEST_PATH]"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The guest user for the provider's default user (default: the provider's own: `user` for E2B, `daytona` for Daytona, `root` for Modal)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "default-user",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "DEFAULT_USER"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua compat serve [OPTIONS]"
    },
    {
     "abstract": "Print the shell exports for a client of the gateway (`eval` them)",
     "after_help": "Examples:\n  cua compat env --provider e2b\n  cua compat env --provider daytona",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "env",
     "options": [
      {
       "aliases": [],
       "default_value": "e2b",
       "env": null,
       "help": "Provider whose SDK the client uses (`e2b`, `daytona`, `modal`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "provider",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PROVIDER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "API listen address of the running gateway",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "listen",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "LISTEN"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Host-router port of the running gateway",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "host-port",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "HOST_PORT"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua compat env [OPTIONS]"
    }
   ],
   "usage": "cua compat [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Disk used by images, sandboxes, builds and logs, and its cleanup",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "cache",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "List what the SDK keeps on disk, one row per image, sandbox, build output, install archive or log",
     "after_help": "Examples:\n  cua cache ls\n  # Only cached images\n  cua cache ls --category images",
     "aliases": [
      "list"
     ],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "ls",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only this category (images, docker-images, lume-bases, builds, installables, icons, sandboxes, checkpoints, logs, data, legacy)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "category",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "CATEGORY"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua cache ls [OPTIONS]"
    },
    {
     "abstract": "Disk usage per category, the cache budget and free space",
     "after_help": "Examples:\n  cua cache du\n  cua cache du --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "du",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua cache du [OPTIONS]"
    },
    {
     "abstract": "Reap orphaned ephemeral sandboxes, remove orphans (abandoned downloads, unused layers) and evict least-recently-used cache down to the budget. Never removes a sandbox or anything one uses",
     "after_help": "Examples:\n  # See what a cleanup would remove\n  cua cache prune --dry-run\n  # Evict every unused cache entry\n  cua cache prune --all",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Evict every unused cache entry, not only down to the budget",
       "hidden": false,
       "name": "all",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Show what would be removed; remove nothing",
       "hidden": false,
       "name": "dry-run",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "prune",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Budget for this run (`auto`, `off` or a size such as `20G`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "budget",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "BUDGET"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua cache prune [OPTIONS]"
    },
    {
     "abstract": "Show or set the cache settings (`$CUA_HOME/cache.json`; the CUA_CACHE_BUDGET, CUA_DISK_MIN_FREE, CUA_DISK_WARN_FREE and CUA_ORPHAN_REAP_MINUTES environment variables win)",
     "after_help": "Examples:\n  # Show the settings\n  cua cache config\n  # Cap the cache at 20 GB and keep 10 GB free\n  cua cache config --budget 20G --min-free 10G",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "config",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Cache budget: `auto` (min of 30 GiB and 10% of free space plus cache), `off`, or a size",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "budget",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "BUDGET"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Free space pulls, builds and VM creates always leave (size)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "min-free",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MIN_FREE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Warn when free space drops under this (size)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "warn-free",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "WARN_FREE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Minutes before an ephemeral sandbox whose process died is reaped",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "orphan-reap-minutes",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "ORPHAN_REAP_MINUTES"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Clean up automatically after pulls and builds and on daemon idle",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "auto-gc",
       "possible_values": [
        "true",
        "false"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "true | false",
       "value_name": "AUTO_GC"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua cache config [OPTIONS]"
    }
   ],
   "usage": "cua cache [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Check the host, an image and a sandbox's guest in one report (`cua doctor [REF]`), or eval parity between two variants (`cua doctor parity A B`)",
   "after_help": "Examples:\n  # Host checks only\n  cua doctor\n  # Host, image and guest checks for the sandbox dev\n  cua doctor dev\n  # CI: fail on warnings, write JUnit XML\n  cua doctor local:dev --strict --junit doctor.xml",
   "aliases": [],
   "arguments": [
    {
     "default_value": null,
     "help": "Sandbox to check: `local:<name>`, `direct:<host:port>`, a bare name, or a spacesd URL. Omit for the host checks only",
     "hidden": false,
     "is_optional": true,
     "name": "TARGET",
     "possible_values": [],
     "repeatable": false,
     "type": "string"
    }
   ],
   "flags": [
    {
     "aliases": [],
     "default_value": false,
     "env": null,
     "help": "Fail on warnings and on required checks that were skipped",
     "hidden": false,
     "name": "strict",
     "repeatable": false,
     "short_name": null,
     "takes_value": false
    },
    {
     "aliases": [],
     "default_value": false,
     "env": null,
     "help": "Skip the host checks",
     "hidden": false,
     "name": "no-host",
     "repeatable": false,
     "short_name": null,
     "takes_value": false
    }
   ],
   "hidden": false,
   "hidden_aliases": [],
   "name": "doctor",
   "options": [
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Image to resolve for the image checks (default: the sandbox's)",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "image",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "IMAGE"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Architecture to resolve the image for (default: the sandbox's, else this host's)",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "arch",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "ARCH"
    },
    {
     "aliases": [],
     "default_value": "human",
     "env": null,
     "help": "Output format (`--json` selects json)",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "format",
     "possible_values": [
      "human",
      "json",
      "junit"
     ],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "human | json | junit",
     "value_name": "FORMAT"
    },
    {
     "aliases": [],
     "default_value": "none",
     "env": null,
     "help": "Which guest checks may act on the guest",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "effects",
     "possible_values": [
      "none",
      "virtual"
     ],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "none | virtual",
     "value_name": "EFFECTS"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Guest check ids or groups to run (comma separated)",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "only",
     "possible_values": [],
     "repeatable": true,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "ONLY"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Guest check ids or groups to skip",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "skip",
     "possible_values": [],
     "repeatable": true,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "SKIP"
    },
    {
     "aliases": [],
     "default_value": "240",
     "env": null,
     "help": "Guest budget in seconds",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "timeout",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "integer",
     "value_name": "TIMEOUT"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": "CUA_ENV_TOKEN",
     "help": "spacesd token for a URL target (default: CUA_ENV_TOKEN)",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "token",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "TOKEN"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Check an image without cua-spacesd through its own API instead: `computer-server=<url>`, `osworld=<url>` or `mcp=<url>`",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "shim",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "KIND=URL"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "The image's claims (manifest JSON), for the shim or to override the guest's own",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "expect-manifest",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "path",
     "value_name": "FILE"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Also write the JSON report here",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "out",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "path",
     "value_name": "FILE"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Also write JUnit XML here",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "junit",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "path",
     "value_name": "FILE"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Check a machine's health instead, as its own cua daemon sees it (the checks the Machines page shows): another of your machines by name or id, over the relay, the mesh or its direct address, or `this`",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "machine",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "MACHINE"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Fail unless the build running in the guest is the expected one: COMPONENT=WANT with WANT `sha256:<hex>` (the executable), `git:<sha>` or a version (repeatable). Components: cua-spacesd, cua-driver, or an overlay name. `cua sb create --overlay` prints the sha256 to pass",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "expect",
     "possible_values": [],
     "repeatable": true,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "COMPONENT=WANT"
    }
   ],
   "subcommand_optional": true,
   "subcommands": [
    {
     "abstract": "Eval parity between two variants of one image (rootfs vs containerDisk): doctor on both, fidelity diff, task outcomes",
     "after_help": "Examples:\n  cua doctor parity local:linux-rootfs local:linux-vm\n  cua doctor parity local:linux-rootfs local:linux-vm --out parity.json",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "First variant (a sandbox ref or a spacesd URL)",
       "hidden": false,
       "is_optional": false,
       "name": "A",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Second variant",
       "hidden": false,
       "is_optional": false,
       "name": "B",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "parity",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": "CUA_ENV_TOKEN",
       "help": "Token for URL targets (both), default CUA_ENV_TOKEN",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "token",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TOKEN"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Token for B when it differs from A's",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "token-b",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TOKEN_B"
      },
      {
       "aliases": [],
       "default_value": "builtin:form,builtin:file",
       "env": null,
       "help": "Tasks (`builtin:form`, `builtin:file`), comma separated",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "tasks",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TASKS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Extra fidelity keys allowed to differ",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "allow-diff",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ALLOW_DIFF"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Write parity.json here",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "out",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "path",
       "value_name": "OUT"
      },
      {
       "aliases": [],
       "default_value": "240",
       "env": null,
       "help": "Doctor budget per variant, seconds",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "timeout",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "TIMEOUT"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua doctor parity [OPTIONS] <A> <B>"
    }
   ],
   "usage": "cua doctor [OPTIONS] [TARGET]\n       cua doctor <COMMAND>"
  },
  {
   "abstract": "Run a Python function on your pool: `FILE::FN`, decorated with `@app.function(...)` (the `cua` jobs shim). Each member runs in a Space (a macOS VM with GPU on a Mac, the computer's own Space on a dedicated host, a container elsewhere); a lost computer re-places the gang and the job resumes from its checkpoints. Rank 0's result is saved in ./cua-runs/<run>/",
   "after_help": "Examples:\n  cua run train.py::finetune\n  cua run train.py::finetune --nodes 1:2 --accelerator gpu\n  cua run train.py::finetune --on host:aws-1 --detach",
   "aliases": [],
   "arguments": [
    {
     "default_value": null,
     "help": "`FILE::FN`: a function decorated with `@app.function(...)` in FILE. Or leave it out and give a command after `--`",
     "hidden": false,
     "is_optional": true,
     "name": "TARGET",
     "possible_values": [],
     "repeatable": false,
     "type": "string"
    },
    {
     "default_value": null,
     "help": "A command to run in a Space instead of `FILE::FN` (`cua run -- CMD ARGS...`); the current directory goes with it like FILE's does",
     "hidden": false,
     "is_optional": true,
     "name": "COMMAND",
     "possible_values": [],
     "repeatable": true,
     "type": "string"
    }
   ],
   "flags": [
    {
     "aliases": [],
     "default_value": false,
     "env": null,
     "help": "Submit, print the run's id and return",
     "hidden": false,
     "name": "detach",
     "repeatable": false,
     "short_name": null,
     "takes_value": false
    }
   ],
   "hidden": false,
   "hidden_aliases": [],
   "name": "run",
   "options": [
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Give the command another provider's sandbox API on Cua Spaces: `e2b`, `daytona` or `modal`. Its SDK finds the gateway in the environment (E2B_API_URL, E2B_API_KEY, ...; DAYTONA_API_URL, DAYTONA_API_KEY; MODAL_SERVER_URL, MODAL_TOKEN_ID, MODAL_TOKEN_SECRET) and needs no code change; the sandboxes it makes are Cua Spaces on your pool",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "compat",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "COMPAT"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "The command's Space kind (`container`, `vm`, `microvm`; default: the host's pick). Command form only",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "kind",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "KIND"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "The command's Space image (default: the host's). Command form only",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "image",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "IMAGE"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Members of the gang, `N` or `MIN:MAX` (default: the decorator's)",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "nodes",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "NODES"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Where: `local` (this machine; the default for a command), `auto` (any of your hosts) or `host:NAME` (default for a function: the decorator's)",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "on",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "ON"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "`gpu` (any), `apple`, `nvidia`, or `none` (default: the decorator's)",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "accelerator",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "ACCELERATOR"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Times the gang is placed again after a failure or a lost computer (default: the decorator's)",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "retries",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "integer",
     "value_name": "RETRIES"
    },
    {
     "aliases": [],
     "default_value": "2",
     "env": null,
     "help": "CPUs reserved for each member",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "cpus",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "number",
     "value_name": "CPUS"
    },
    {
     "aliases": [],
     "default_value": "4096",
     "env": null,
     "help": "Memory reserved for each member, in MiB",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "memory",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "integer",
     "value_name": "MEMORY"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "`KEY=VALUE` for every member's environment (over the decorator's `env=`), or `KEY` alone for this shell's value (secrets: never printed). Repeatable",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "env",
     "possible_values": [],
     "repeatable": true,
     "short_name": "e",
     "takes_value": true,
     "type": "string",
     "value_name": "KEY=VALUE"
    },
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "The run's id (default: a new one)",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "id",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "ID"
    }
   ],
   "subcommand_optional": false,
   "subcommands": [],
   "usage": "cua run [OPTIONS] [TARGET] [-- <COMMAND>...]"
  },
  {
   "abstract": "Runs on your pool: the list, one run's members and cost, its logs, cancel, and its result",
   "after_help": "Examples:\n  cua jobs\n  cua jobs p-finetune-1a2b3c4d\n  cua jobs logs -f p-finetune-1a2b3c4d --rank 0\n  cua jobs cancel p-finetune-1a2b3c4d\n  cua jobs result p-finetune-1a2b3c4d -o ./adapter",
   "aliases": [],
   "arguments": [
    {
     "default_value": null,
     "help": "A run: its members, attempts, hosts, state and cost",
     "hidden": false,
     "is_optional": true,
     "name": "RUN",
     "possible_values": [],
     "repeatable": false,
     "type": "string"
    }
   ],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "jobs",
   "options": [],
   "subcommand_optional": true,
   "subcommands": [
    {
     "abstract": "A run's output, every rank (`[rank R host]`) or one",
     "after_help": "Examples:\n  cua jobs logs -f p-finetune-1a2b3c4d\n  cua jobs logs p-finetune-1a2b3c4d --rank 1",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The run",
       "hidden": false,
       "is_optional": false,
       "name": "RUN",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Keep following until the run ends",
       "hidden": false,
       "name": "follow",
       "repeatable": false,
       "short_name": "f",
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "logs",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only this rank",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "rank",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "RANK"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua jobs logs [OPTIONS] <RUN>"
    },
    {
     "abstract": "Cancel a run (every member stops)",
     "after_help": "Examples:\n  cua jobs cancel p-finetune-1a2b3c4d",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The run",
       "hidden": false,
       "is_optional": false,
       "name": "RUN",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "cancel",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua jobs cancel [OPTIONS] <RUN>"
    },
    {
     "abstract": "Save rank 0's result",
     "after_help": "Examples:\n  cua jobs result p-finetune-1a2b3c4d\n  cua jobs result p-finetune-1a2b3c4d -o ./adapter",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The run",
       "hidden": false,
       "is_optional": false,
       "name": "RUN",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "result",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Directory (default ./cua-runs/<run>)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "output",
       "possible_values": [],
       "repeatable": false,
       "short_name": "o",
       "takes_value": true,
       "type": "path",
       "value_name": "OUTPUT"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua jobs result [OPTIONS] <RUN>"
    }
   ],
   "usage": "cua jobs [OPTIONS] [RUN]\n       cua jobs <COMMAND>"
  },
  {
   "abstract": "The computers in your pool, as its coordinator sees them now: state, OS/arch, load, jobs, accelerators and $/h, with the queue",
   "after_help": "Examples:\n  cua computers\n  cua computers --json",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "computers",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [],
   "usage": "cua computers [OPTIONS]"
  },
  {
   "abstract": "Now `cua spaces` (kept for one release)",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": true,
   "hidden_aliases": [],
   "name": "machines",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Remove a computer that is gone: its row leaves your relay directory, then the signed-in device with exactly its name is revoked (never this device; nothing when several match). A computer that is connected now is refused: run `cua host remove` on it",
     "after_help": "Examples:\n  cua spaces rm old-laptop\n  cua spaces rm relay:0123abcd4567ef89 --yes --json",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The computer's name, machine id or `relay:<id>` (`cua spaces ls`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Remove without asking",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": "y",
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "rm",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua machines rm [OPTIONS] <NAME>"
    }
   ],
   "usage": "cua machines [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Unattended access to this computer (setup, status, stop, start, remove)",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "host",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Set this computer up for unattended access: install cua-spacesd as a service that joins the cua.ai relay as your account (default) or serves on a direct ip:port. By default it shares this computer's desktop and, on a computer set up for the first time through the relay, provides Spaces to your devices (a host in your pool: `cua run` jobs and `--on auto` Spaces can run here, within its limits). `--share` picks what it shares: `desktop`, `spaces` (its own desktop stays private), `both` or `none`; `cua host config` changes it later. A computer set up before keeps what it provides. Running it again with the same options changes nothing (a stopped service starts again)",
     "after_help": "Examples:\n  # Join the cua.ai relay as your account (shares this desktop and\n  # provides Spaces to your devices)\n  cua host setup\n  # Share this desktop only\n  cua host setup --share desktop\n  # A spare computer: do not share its desktop, run Spaces for your devices\n  cua host setup --share spaces --name \"Mac mini (spare)\"\n  # Add this computer with a one-time code from the Cua Spaces app\n  # (Add a computer) or `cua host pair`: no sign-in needed here\n  cua host setup --pair K7QM-4XPB-2RHD\n  # Keep this computer off the end-to-end encrypted mesh (relay HTTPS only):\n  # run setup with CUA_MESH=off in the environment\n  # Self-hosting teams: cua help advanced",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "When sign-in is needed, use a device code to approve it in a browser on another computer. The account session is not saved",
       "hidden": false,
       "name": "remote",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Hidden alias of the desktop half of `--share`",
       "hidden": true,
       "name": "desktop",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Hidden alias of `--share spaces` with `--provide-spaces`",
       "hidden": true,
       "name": "no-desktop",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Hidden alias: with the default profile, `--share both`",
       "hidden": true,
       "name": "provide-spaces",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Hidden alias: with the default profile, `--share desktop`",
       "hidden": true,
       "name": "no-provide-spaces",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "With --direct and Spaces: take host calls, and connections to the Spaces this computer forwards, from any address (and allow a public --direct address). By default only loopback, Tailscale and private LAN addresses may. The direct listener is plaintext and its token is a shell on this computer: prefer Tailscale",
       "hidden": true,
       "name": "allow-any-address",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Serve on this machine's tailnet address (Tailscale or Headscale; port 3211 unless --direct says otherwise), and let the tailnet identify callers: you (this machine's tailnet user) and the tailnet users you --allow need no env token. Your tailnet's ACLs decide who can reach it at all",
       "hidden": true,
       "name": "tailnet",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "This computer exists only for Cua work (a cloud instance made for it; `cua cloud add aws` sets its hosts up this way): jobs may run in its own Space (`kind = \"machine\"`), with its GPU and drivers as they are. Never on a computer you also use: there jobs run in macOS VMs or containers",
       "hidden": false,
       "name": "dedicated",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "setup",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Relay URL (default $CUA_RELAY_URL, else the CUA_ENV relay, https://relay.cua.ai in production)",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "relay",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RELAY"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Join with a one-time pairing code (or add-machine link) made in the Cua Spaces app or with `cua host pair`, instead of signing in here. The computer joins the account (or team) that made it",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "pair",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "CODE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Serve directly on ip:port with a local env token (LAN / port-forwarded) instead of joining a relay",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "direct",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "DIRECT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Display name (default: the host name)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "name",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Also allow this account (id or email). Repeatable",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "allow",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ALLOW"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "cua-spacesd binary (default $CUA_SPACESD_BIN, a bundled one, or the release download)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "driver-bin",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "path",
       "value_name": "DRIVER_BIN"
      },
      {
       "aliases": [],
       "default_value": "auto",
       "env": null,
       "help": "auto | systemd | launchd | app-helper | windows-task | process. On a Mac with the Cua Spaces app, auto is app-helper: the service runs as the app's own login item (\"Cua Spaces\")",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "runner",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RUNNER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "What this computer shares: its own desktop (screen, input, shell, files), the Spaces it creates for your enrolled devices (Lume macOS VMs, Docker Linux containers), both, or neither (refused). Default: the desktop, plus Spaces on a new relay setup; a computer set up before keeps what it provides",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "share",
       "possible_values": [
        "desktop",
        "spaces",
        "both",
        "none"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "desktop | spaces | both | none",
       "value_name": "WHAT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Hidden alias: `--share spaces` is `--profile spare`",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "profile",
       "possible_values": [
        "desktop",
        "spare"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "desktop | spare",
       "value_name": "PROFILE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Provided Spaces at once (default 4; 0: no limit)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-spaces",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MAX_SPACES"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua host setup [OPTIONS]"
    },
    {
     "abstract": "Make a one-time code (with a link and the install command) that adds another computer to your account: run the command it prints on that computer. Codes work once and expire (30 minutes by default). Run from an enrolled device",
     "after_help": "Examples:\n  cua host pair\n  cua host pair --name build-box --expires 60\n  cua host pair --list\n  cua host pair --revoke pc_0123456789abcdef\n  # Add the computer to a team: waits for it to join, then adds it\n  cua host pair --team AIGIS",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "With --team: print the code and exit instead of waiting; add the computer later with `cua team add-machine <team> relay:<id>`",
       "hidden": false,
       "name": "no-wait",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "List your codes (used, unused, revoked, expired) instead",
       "hidden": false,
       "name": "list",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "pair",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Add the computer to this team (id, alias or name; owner or admin): waits until the computer joins, then makes it a team computer",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "team",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TEAM"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Name the computer gets (default: its own host name)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "name",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME"
      },
      {
       "aliases": [],
       "default_value": "30",
       "env": null,
       "help": "Minutes until the code expires (1 to 1440)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "expires",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MINUTES"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Revoke an unused code by id (`pc_…`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "revoke",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ID"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Relay URL (default $CUA_RELAY_URL, else the CUA_ENV relay, https://relay.cua.ai in production)",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "relay",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RELAY"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua host pair [OPTIONS]"
    },
    {
     "abstract": "Show or change what this computer shares: its own desktop, and whether it creates Spaces for your other devices",
     "after_help": "Examples:\n  cua host config\n  # Stop sharing this desktop; keep providing Spaces\n  cua host config --desktop off --provide-spaces on\n  cua host config --max-spaces 6\n  # Give the Spaces other machines create here at most 32 GB of memory and\n  # 200 GB of disk in total, and stop each after 8 hours (0: no limit)\n  cua host config --max-memory 32 --max-disk 200 --max-run-time 480\n  # Keep no copies of public git repositories on this machine, or at most 2 GB\n  cua host config --repo-cache off\n  cua host config --repo-cache on --repo-cache-size 2",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "config",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Share this computer's own desktop: on | off",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "desktop",
       "possible_values": [
        "on",
        "off"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "on | off",
       "value_name": "DESKTOP"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Create Spaces for your enrolled devices: on | off",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "provide-spaces",
       "possible_values": [
        "on",
        "off"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "on | off",
       "value_name": "PROVIDE_SPACES"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Provided Spaces at once (0: no limit)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-spaces",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MAX_SPACES"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "macOS VMs at once, 0 to 2 (Apple's license allows two per Mac)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-macos-vms",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MAX_MACOS_VMS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Memory in GB the Spaces other machines create here may use in total (0: no limit)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-memory",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "GB"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Disk in GB the Spaces other machines create here may use in total (0: no limit)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-disk",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "GB"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Minutes a Space created here by another machine may run before it is stopped (0: no limit)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-run-time",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MINUTES"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The repo cache: on | off. It keeps verified copies of public git repositories on this machine so a repeat `git clone` in a Space starts from one (never private repositories, never anything off this machine's disk)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "repo-cache",
       "possible_values": [
        "on",
        "off"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "on | off",
       "value_name": "REPO_CACHE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The most disk the repo cache may use, in GB (`auto`: the smaller of 5 GB and a tenth of the free disk). The least recently used repositories go first",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "repo-cache-size",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "GB"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua host config [OPTIONS]"
    },
    {
     "abstract": "What the repo cache holds, and empty it",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "cache",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [
      {
       "abstract": "What the repo cache holds: repositories, size and what the last week saved",
       "after_help": "Examples:\n  cua host cache status",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "status",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua host cache status [OPTIONS]"
      },
      {
       "abstract": "Copy one public repository into the cache now, instead of when a Space first clones it (or bring a copy up to date). A repository that needs a sign-in is never cached",
       "after_help": "Examples:\n  cua host cache fill https://github.com/vitejs/vite",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "The repository's `https` address",
         "hidden": false,
         "is_optional": false,
         "name": "URL",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "fill",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua host cache fill [OPTIONS] <URL>"
      },
      {
       "abstract": "Delete every repository the cache holds. They are copied again the next time a Space clones them",
       "after_help": "Examples:\n  cua host cache clear",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "clear",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua host cache clear [OPTIONS]"
      }
     ],
     "usage": "cua host cache [OPTIONS] <COMMAND>"
    },
    {
     "abstract": "Show whether this computer is set up, the service, and who is connected",
     "after_help": "Examples:\n  cua host status",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "status",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua host status [OPTIONS]"
    },
    {
     "abstract": "Stop sharing: disconnect everyone and refuse new connections",
     "after_help": "Examples:\n  cua host stop",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "stop",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua host stop [OPTIONS]"
    },
    {
     "abstract": "Start sharing again after `stop`",
     "after_help": "Examples:\n  cua host start",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "start",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua host start [OPTIONS]"
    },
    {
     "abstract": "Share a relay computer (this one, or `--machine`) with people in your team (id or verified email). Run from an enrolled device; every change is in the owner's audit log (`cua devices audit`)",
     "after_help": "Examples:\n  cua host share [email protected]\n  cua host share [email protected] --machine 0123abcd4567ef89 --yes",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Accounts to add. Repeatable",
       "hidden": false,
       "is_optional": false,
       "name": "WHO",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not ask for confirmation",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "share",
     "options": [
      {
       "aliases": [
        "computer"
       ],
       "default_value": null,
       "env": null,
       "help": "Computer id (default: this computer)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "machine",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "COMPUTER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Relay URL (default: the one this computer joined, else $CUA_RELAY_URL / https://relay.cua.ai)",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "relay",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RELAY"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua host share [OPTIONS] <WHO>..."
    },
    {
     "abstract": "Stop sharing a relay computer with accounts; their open connections are cut",
     "after_help": "Examples:\n  cua host unshare [email protected]",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Accounts to remove. Repeatable",
       "hidden": false,
       "is_optional": false,
       "name": "WHO",
       "possible_values": [],
       "repeatable": true,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "unshare",
     "options": [
      {
       "aliases": [
        "computer"
       ],
       "default_value": null,
       "env": null,
       "help": "Computer id (default: this computer)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "machine",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "COMPUTER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Relay URL",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "relay",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RELAY"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua host unshare [OPTIONS] <WHO>..."
    },
    {
     "abstract": "macOS: move the host service into the Cua Spaces app, as its \"Cua Spaces Helper\" login item, from the LaunchAgent that older versions installed. This machine keeps its id, registration and Spaces; if the helper does not take over, the old service is put back. macOS then asks once for Screen Recording and Accessibility for Cua Spaces Helper",
     "after_help": "Examples:\n  cua host migrate\n  # Try again after a move that was rolled back\n  cua host migrate --force",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Try again even if a move failed before with this version",
       "hidden": false,
       "name": "force",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "migrate",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua host migrate [OPTIONS]"
    },
    {
     "abstract": "Unregister from the relay, uninstall the service and delete the host configuration (asks first)",
     "after_help": "Examples:\n  cua host remove\n  # Without the prompt (required in scripts and agents)\n  cua host remove --force",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Skip the confirmation prompt. Required when there is no terminal to ask on (scripts, agents): without it nothing is removed",
       "hidden": false,
       "name": "force",
       "repeatable": false,
       "short_name": "f",
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "For an uninstall of Cua Spaces: turns off the Spaces this computer provides and takes them off the relay too, instead of refusing while it provides any. The Spaces and their data stay on this computer",
       "hidden": false,
       "name": "uninstalling",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "remove",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua host remove [OPTIONS]"
    }
   ],
   "usage": "cua host [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Spaces: registered ones and your computers on the relay",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "spaces",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Registered Spaces and your computers on the relay",
     "after_help": "CPU, MEMORY and the DISK column (on this computer) show what each Space was given and what it\nuses now (the numbers the Cua Spaces app shows); for another of your\ncomputers they show what it last reported. Numbers only: no file names.\n\nExamples:\n  cua spaces ls\n  cua spaces ls --no-size\n  cua spaces ls --json\n  # Only the Spaces created with these labels\n  cua spaces ls --label team=research --label run=7",
     "aliases": [
      "list"
     ],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not measure what each Space takes on this computer's disk (that walk can take a moment with many Spaces)",
       "hidden": false,
       "name": "no-size",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "List child Spaces under their parent, indented (otherwise the parent's row counts them)",
       "hidden": false,
       "name": "tree",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "ls",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Relay URL (default $CUA_RELAY_URL, else the CUA_ENV relay, https://relay.cua.ai in production)",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "relay",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RELAY"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only Spaces with this label (`key=value`; repeat to require several)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "label",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "KEY=VALUE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces ls [OPTIONS]"
    },
    {
     "abstract": "Register a Space after a capabilities handshake with its cua-spacesd (or, for another URL, an MCP initialize). Re-adding an address updates it. The token is stored apart from the registry, 0600",
     "after_help": "Examples:\n  cua spaces add 10.0.0.5:3211 --token \"$TOKEN\" --name studio\n  cua spaces add local:my-sandbox\n  cua spaces add http://127.0.0.1:8765/mcp --service tools\n  # A computer that provides Spaces over Tailscale, without the relay\n  # (`cua host setup --direct ... --share both` on it prints this)\n  cua spaces add 100.101.102.103:3211 --host --name \"Mac mini (spare)\" --token \"$TOKEN\"",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The Space's cua-spacesd (`http(s)://host:port`, `host:port`, default port 3211), a Space id (`local:<name>`), or any MCP endpoint URL",
       "hidden": false,
       "is_optional": false,
       "name": "URL",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "It is a computer that provides Spaces over its direct address (Tailscale or LAN): `--on host:<name>` finds it without the relay. Its token is stored like any direct Space's",
       "hidden": false,
       "name": "host",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "add",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": "CUA_ENV_TOKEN",
       "help": "spacesd token (or the bearer an MCP endpoint needs)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "token",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TOKEN"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Display name (default: the guest's hostname)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "name",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "For an MCP endpoint URL: the service name to register it under (default `mcp`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "service",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SERVICE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces add [OPTIONS] <URL>"
    },
    {
     "abstract": "Create Spaces: on this computer, on one of your computers that provides Spaces (`cua host setup --share spaces` there), or in your own cloud account",
     "after_help": "Examples:\n  cua spaces create linux\n  # On the least-loaded of your machines\n  cua spaces create linux --on auto\n  # Two macOS VMs on your spare Mac mini (matched by name)\n  cua spaces create macos:26 --on \"spare mac mini\" --count 2\n  cua spaces create --on host:0123abcd4567ef89 linux --json\n  # Kept on your machines: created again on another one if its machine goes away\n  cua spaces create linux --on auto --durable --name research\n  # In your AWS account, on a pool host of exactly this type and region\n  cua spaces create linux --on aws --instance-type c7g.xlarge --region us-west-2\n  # Labels are kept with the Space; `cua spaces ls --label team=research` filters\n  cua spaces create linux --label team=research --label run=7",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Image: an alias (`linux`, `macos`, `macos:26`) or a registry reference. Default: the canonical Linux image",
       "hidden": false,
       "is_optional": true,
       "name": "IMAGE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Keep it on your machines (with `--on auto`): when its machine goes away it is created again on another one, with the same name (its disk starts fresh). `cua spaces delete <name>` deletes it for good",
       "hidden": false,
       "name": "durable",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Let it make child Spaces of its own: `cua`, the SDKs and the agent's tools in it create, list and delete Spaces that belong to it, on this computer, never wider than it (`cua spaces children`). Agent runs turn this on by themselves",
       "hidden": false,
       "name": "children",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "A fork source (a \"bake\" Space): a local QEMU VM's guest RAM is a shared file, so `cua sb checkpoint` takes milliseconds and forks of its checkpoints share its pages. Other kinds ignore it",
       "hidden": false,
       "name": "forkable",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Keep it off your cua.ai account. By default a Space running on a computer signed in and sharing is listed there, so your phone and your other computers see and open it (`cua config set relay.spaces off` turns that off for all of them). A child Space follows its parent. Same as `--label cua.relay=off`",
       "hidden": false,
       "name": "no-relay",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "With --parent: let its network be more open than its parent's (recorded on the Space)",
       "hidden": false,
       "name": "widen",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "create",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Where: `local`, `auto` (the least-loaded of your computers), `aws`, `gcp`, `modal`, `host:<computer>`, or a computer name (`mac-mini`, \"spare mac mini\"). Default: your default location (`local` unless set)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "on",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ON"
      },
      {
       "aliases": [],
       "default_value": "1",
       "env": null,
       "help": "How many (1 to 8)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "count",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "COUNT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Name (with --count, `-2`, `-3`, ... are appended)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "name",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "auto | container | vm | microvm",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "kind",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "KIND"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "auto, or an engine the location offers (lume, runc, gvisor, qemu)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "runtime",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RUNTIME"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "vCPUs",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cpus",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "CPUS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Memory in MiB",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "memory-mb",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MEMORY_MB"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Grow a VM's disk to this many GiB",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "disk-gb",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "DISK_GB"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A GPU: the runtime's own (`--gpu`), or an option `cua spaces gpus` lists. macOS VMs: GPU acceleration (experimental, Apple silicon; https://cua.ai/docs/lume/guides/gpu-passthrough)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "gpu",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "OPTION"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The cloud machine type of the pool host it runs on (with `--on <cloud>` or `--on auto`; default: the pool picks)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "instance-type",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "INSTANCE_TYPE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The cloud region or location of that host (default: the pool picks, near you)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "region",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REGION"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Mount a named volume of Cua Volume in the Space: `NAME:PATH[:ro|:rw]`, or `NAME/SUBFOLDER:PATH[:ro|:rw]` for a folder of it. With Secure Spaces on it is read-only unless you add `:rw`. Repeat for several. Make one with `cua volume named create`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "volume",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME:PATH[:ro|:rw]"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A label to keep with the Space (`key=value`; repeat for more; up to 64, keys up to 63 bytes, values up to 256, none empty). Not with `--durable`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "label",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "KEY=VALUE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Its network: `internet` (the default: the internet and its own tree; this computer, your local network, cloud metadata and other trees are blocked), `none`, `localhost:5432,3000` (also this computer's localhost on those ports), `lan` (also your local network), `custom` / `custom:none` (with --allow/--deny), or `unprotected` (No protection). Enforced by the host, outside the guest. See `cua network`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "network",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PRESET"
      },
      {
       "aliases": [
        "egress-deny"
       ],
       "default_value": null,
       "env": null,
       "help": "Block this destination (IP, CIDR or `all`; repeat for more)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "deny",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ADDR|CIDR|all"
      },
      {
       "aliases": [
        "egress-allow"
       ],
       "default_value": null,
       "env": null,
       "help": "Allow this destination, also where a block covers it (IP or CIDR; repeat for more). This computer itself opens only with `--network localhost:<ports>`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "allow",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ADDR|CIDR"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Create it as a child of this Space: it joins the parent's tree (they reach each other) and its network is no more open than the parent's. With `--parent`, the children are deleted, stopped and suspended with it",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "parent",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SPACE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces create [OPTIONS] [IMAGE]"
    },
    {
     "abstract": "Keep Spaces of one image ready where the elastic pool puts them, so the next creates of that shape start in a fraction of a second (`--list` shows the prewarms, `--remove ID` ends one)",
     "after_help": "Examples:\n  cua spaces prewarm ghcr.io/trycua/linux:24.04-slim --count 16 --on aws --ttl 1h\n  cua spaces prewarm linux --count 4 --kind container --cpus 1 --memory-mb 512\n  cua spaces prewarm --list\n  cua spaces prewarm --remove pw-1a2b3c",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Image (an alias or a registry reference)",
       "hidden": false,
       "is_optional": true,
       "name": "IMAGE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "List the prewarms and how many each keeps ready",
       "hidden": false,
       "name": "list",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "prewarm",
     "options": [
      {
       "aliases": [],
       "default_value": "1",
       "env": null,
       "help": "How many to keep ready (1 to 256)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "count",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "COUNT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Where: `auto` (default), `local`, a linked cloud or `host:<machine>`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "on",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ON"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "How long to keep them (`30m`, `2h`; default 1h, at most 7d)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "ttl",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TTL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "auto | container | vm | microvm",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "kind",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "KIND"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "vCPUs each",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cpus",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "CPUS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Memory each, MiB",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "memory-mb",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MEMORY_MB"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only this cloud machine type",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "instance-type",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "INSTANCE_TYPE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only this cloud region",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "region",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REGION"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "End a prewarm (its ready Spaces go)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "remove",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ID"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces prewarm [OPTIONS] [IMAGE]"
    },
    {
     "abstract": "Choose which destinations a Space may reach: block some, or block everything except a few. The machine the Space runs on enforces it, outside the guest (nothing in the guest, root included, can change it). Replaces the whole policy at once; `--clear` removes it. By IP address or CIDR (`all` is every address), not by hostname. DNS works only while the resolver the guest uses is not blocked",
     "after_help": "Examples:\n  # Block one network\n  cua spaces egress studio --deny 10.0.0.0/8\n  # Only 1.1.1.1 and one network stay reachable\n  cua spaces egress studio --deny all --allow 1.1.1.1 --allow 203.0.113.0/24\n  # Back to unrestricted\n  cua spaces egress studio --clear",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id or name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "discussion": ".\n\nEverything is allowed unless a rule says otherwise: every --deny entry blocks that destination, and every --allow entry is an exception that wins over a --deny. --allow alone blocks nothing. Loopback, replies to connections made to the Space and IPv6 neighbor discovery are never filtered. Containers (runc, gVisor), and QEMU and Firecracker VMs on Linux take a policy; macOS VMs, Apple Containerization, Cua Cloud and your own cloud accounts refuse one and say why.",
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Remove the policy",
       "hidden": false,
       "name": "clear",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "egress",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A destination to block (IPv4/IPv6 address, CIDR or `all`; repeat for more)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "deny",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ADDR|CIDR|all"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A destination that stays reachable where --deny blocks it (repeat for more)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "allow",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ADDR|CIDR|all"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces egress [OPTIONS] <SPACE>"
    },
    {
     "abstract": "Let a Space make child Spaces of its own, or stop it. While on, `cua`, the SDKs and the agent's tools inside it create, list and delete Spaces that belong to it: on this computer, with its egress rules, ending no later than it, through a channel only it can reach. Off ends its capability at once; children it made keep running until deleted or their lifetime ends",
     "after_help": "Examples:\n  cua spaces children studio on\n  cua spaces children studio off",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id or name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "`on` or `off`",
       "hidden": false,
       "is_optional": false,
       "name": "STATE",
       "possible_values": [
        "on",
        "off"
       ],
       "repeatable": false,
       "type": "on | off"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "children",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces children [OPTIONS] <SPACE> <STATE>"
    },
    {
     "abstract": "Show or set a tree's budget: how many child Spaces, vCPUs and memory its children may hold at once, and what they may cost. A child that does not fit is refused with what is left. Without flags it shows the budget and what the children use",
     "after_help": "Examples:\n  cua spaces budget studio\n  cua spaces budget studio --spaces 32 --cpus 64 --memory 131072\n  cua spaces budget studio --usd-per-hour 5 --usd-total 50\n  cua spaces budget studio --clear",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Any Space of the tree (id or name)",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Back to the defaults",
       "hidden": false,
       "name": "clear",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "budget",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Child Spaces at once (default 16)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "spaces",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "SPACES"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "vCPUs at once (default 16)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cpus",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "CPUS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Memory at once, in MiB (default 32768)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "memory",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MIB"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Cost per hour in linked clouds, in dollars (default 2)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "usd-per-hour",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "number",
       "value_name": "USD"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Cost in total, in dollars (default: none)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "usd-total",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "number",
       "value_name": "USD"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces budget [OPTIONS] <SPACE>"
    },
    {
     "abstract": "List child Spaces whose parent is gone or out of reach. The daemon ends a child only on proof its parent is gone, after a grace period; the others stay until you delete them or their lifetime ends",
     "after_help": "Examples:\n  cua spaces orphans",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "orphans",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces orphans [OPTIONS]"
    },
    {
     "abstract": "Keep a command running in a Space: started again when it exits or fails its health check (with a backoff), started when the Space boots, its output kept in a log file in the Space",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "service",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [
      {
       "abstract": "Keep a command running (replaces a service of that name)",
       "after_help": "Examples:\n  cua spaces service add studio web -- python3 -m http.server 8080\n  cua spaces service add studio web --http http://127.0.0.1:8080/ -- python3 -m http.server 8080\n  cua spaces service add studio job --restart on-failure -- ./run.sh",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Space id or name",
         "hidden": false,
         "is_optional": false,
         "name": "SPACE",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        },
        {
         "default_value": null,
         "help": "Service name (lowercase letters, digits, `-`, `_`, `.`)",
         "hidden": false,
         "is_optional": false,
         "name": "NAME",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        },
        {
         "default_value": null,
         "help": "The command (after `--`)",
         "hidden": false,
         "is_optional": false,
         "name": "COMMAND",
         "possible_values": [],
         "repeatable": true,
         "type": "string"
        }
       ],
       "flags": [
        {
         "aliases": [],
         "default_value": false,
         "env": null,
         "help": "Do not start it when the Space boots",
         "hidden": false,
         "name": "no-boot",
         "repeatable": false,
         "short_name": null,
         "takes_value": false
        }
       ],
       "hidden": false,
       "hidden_aliases": [],
       "name": "add",
       "options": [
        {
         "aliases": [],
         "default_value": "always",
         "env": null,
         "help": "When to start it again: always, on-failure or never",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "restart",
         "possible_values": [
          "always",
          "on-failure",
          "never"
         ],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "always | on-failure | never",
         "value_name": "RESTART"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Health check: a URL that answers 2xx or 3xx",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "http",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "HTTP"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Health check: `host:port` that accepts a connection",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "tcp",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "TCP"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Health check: a shell command that exits 0 when healthy",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "check",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "CHECK"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "`KEY=VALUE` for its environment (repeat for more)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "env",
         "possible_values": [],
         "repeatable": true,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "KEY=VALUE"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Working directory in the Space",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "cwd",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "CWD"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua spaces service add [OPTIONS] <SPACE> <NAME> -- <COMMAND>..."
      },
      {
       "abstract": "List a Space's services",
       "after_help": "Examples:\n  cua spaces service ls studio",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Space id or name",
         "hidden": false,
         "is_optional": false,
         "name": "SPACE",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "ls",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua spaces service ls [OPTIONS] <SPACE>"
      },
      {
       "abstract": "Show the end of a service's log",
       "after_help": "Examples:\n  cua spaces service logs studio web",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Space id or name",
         "hidden": false,
         "is_optional": false,
         "name": "SPACE",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        },
        {
         "default_value": null,
         "help": "Service name",
         "hidden": false,
         "is_optional": false,
         "name": "NAME",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "logs",
       "options": [
        {
         "aliases": [],
         "default_value": "65536",
         "env": null,
         "help": "Bytes from the end",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "tail",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "integer",
         "value_name": "TAIL"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua spaces service logs [OPTIONS] <SPACE> <NAME>"
      },
      {
       "abstract": "Start a stopped service",
       "after_help": "Examples:\n  cua spaces service start studio web",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Space id or name",
         "hidden": false,
         "is_optional": false,
         "name": "SPACE",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        },
        {
         "default_value": null,
         "help": "Service name",
         "hidden": false,
         "is_optional": false,
         "name": "NAME",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "start",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua spaces service start [OPTIONS] <SPACE> <NAME>"
      },
      {
       "abstract": "Stop a service and keep it stopped",
       "after_help": "Examples:\n  cua spaces service stop studio web",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Space id or name",
         "hidden": false,
         "is_optional": false,
         "name": "SPACE",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        },
        {
         "default_value": null,
         "help": "Service name",
         "hidden": false,
         "is_optional": false,
         "name": "NAME",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "stop",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua spaces service stop [OPTIONS] <SPACE> <NAME>"
      },
      {
       "abstract": "Restart a service",
       "after_help": "Examples:\n  cua spaces service restart studio web",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Space id or name",
         "hidden": false,
         "is_optional": false,
         "name": "SPACE",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        },
        {
         "default_value": null,
         "help": "Service name",
         "hidden": false,
         "is_optional": false,
         "name": "NAME",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "restart",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua spaces service restart [OPTIONS] <SPACE> <NAME>"
      },
      {
       "abstract": "Stop a service and forget it",
       "after_help": "Examples:\n  cua spaces service rm studio web",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "Space id or name",
         "hidden": false,
         "is_optional": false,
         "name": "SPACE",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        },
        {
         "default_value": null,
         "help": "Service name",
         "hidden": false,
         "is_optional": false,
         "name": "NAME",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "rm",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua spaces service rm [OPTIONS] <SPACE> <NAME>"
      }
     ],
     "usage": "cua spaces service [OPTIONS] <COMMAND>"
    },
    {
     "abstract": "Cancel a create that is still running (here, in the daemon, or in another terminal): it stops and what it made is removed. Finished image downloads stay cached. Ctrl-C during `cua spaces create` does the same",
     "after_help": "Examples:\n  cua spaces cancel local:space-1a2b3c\n  cua spaces cancel studio",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The id the Space will have (`local:<name>`, printed when the create starts) or its name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "cancel",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces cancel [OPTIONS] <SPACE>"
    },
    {
     "abstract": "The GPU options each runtime offers on this computer (or in your own cloud account)",
     "after_help": "Examples:\n  cua spaces gpus\n  cua spaces gpus --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "gpus",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "`local` (default), `aws`, `gcp` or `modal`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "on",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ON"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces gpus [OPTIONS]"
    },
    {
     "abstract": "Delete a Space's sandbox (on this computer, on the computer that provides it, or in your own cloud account) and forget it (asks first)",
     "after_help": "Examples:\n  cua spaces delete relay:space-0123456789abcdef\n  cua spaces delete local:studio --force",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id or name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Skip the confirmation (required without a terminal)",
       "hidden": false,
       "name": "force",
       "repeatable": false,
       "short_name": "f",
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Keep its child Spaces: they become top-level Spaces and keep running (otherwise they are deleted first)",
       "hidden": false,
       "name": "keep-children",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "delete",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces delete [OPTIONS] <SPACE>"
    },
    {
     "abstract": "Turn a Space off: a local VM (QEMU or Lume) or a Space one of your computers provides is stopped, keeping its disk and freeing its memory, and so is a Space in your own cloud (`--on aws`, `gcp`: compute billing stops; `hetzner`: still billed). A local container is stopped or suspended as its runtime can. `cua spaces suspend` keeps a local Space's memory instead. Modal sandboxes and Spaces added by address cannot be turned off",
     "after_help": "Examples:\n  cua spaces stop local:studio\n  cua spaces stop relay:space-0123456789abcdef --json",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id or name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "stop",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces stop [OPTIONS] <SPACE>"
    },
    {
     "abstract": "Suspend a local Space (a container or QEMU VM): its memory is kept, and stays in use, so it resumes where it was with `cua spaces start`. `cua spaces stop` frees the memory instead",
     "after_help": "Examples:\n  cua spaces suspend local:studio",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id or name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "suspend",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces suspend [OPTIONS] <SPACE>"
    },
    {
     "abstract": "Give a local VM Space more or fewer vCPUs, more or less memory, or a bigger disk. It shuts down and boots again from its own disk (a stopped one boots): its files stay, its running processes do not. A disk never shrinks",
     "after_help": "Examples:\n  cua spaces resize local:builder --memory-mb 24576\n  cua spaces resize builder --cpus 8 --disk-gb 200 --json",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id or name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "resize",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "vCPUs",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cpus",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "CPUS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Memory in MiB",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "memory-mb",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MEMORY_MB"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Grow the disk to this many GiB",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "disk-gb",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "DISK_GB"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces resize [OPTIONS] <SPACE>"
    },
    {
     "abstract": "Turn a Space back on: resume a suspended one or boot a stopped one",
     "after_help": "Examples:\n  cua spaces start local:studio\n  cua spaces start studio --json",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id or name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "start",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces start [OPTIONS] <SPACE>"
    },
    {
     "abstract": "Forget a registered Space and its stored token. The sandbox keeps running. A Space cua created (on this computer or in a cloud) is refused while its sandbox exists: use `cua spaces delete` (or `stop`). The `relay:<computer>` record of a Space that registered itself and is gone (not connected) also leaves your relay directory",
     "after_help": "Examples:\n  cua spaces rm direct:10.0.0.5:3211\n  cua spaces rm studio",
     "aliases": [
      "remove"
     ],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id, address or display name (as `cua spaces ls` shows)",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "For one of your computers: also delete the Spaces it provides and their files (through the computer while it is reachable). Without it they stay on your account, detached, and come back if the computer is added again",
       "hidden": false,
       "name": "delete-spaces",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Remove a computer without asking",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": "y",
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "rm",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces rm [OPTIONS] <SPACE>"
    },
    {
     "abstract": "Your default Space: where \"my Space\" goes when you do not say. With no argument it prints the Space it resolves to now and the order it tries (online or not); with a Space it sets the default",
     "after_help": "Examples:\n  cua spaces default\n  cua spaces default studio\n  cua spaces default studio --fallback office-pc,relay:0123abcd4567ef89\n  # Only the default, then this computer\n  cua spaces default --no-fallback\n  # Back to trying every online computer, oldest first\n  cua spaces default --fallback-on\n  cua spaces default --clear",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The Space to make your default: a name or id (as `cua spaces ls` shows)",
       "hidden": false,
       "is_optional": true,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Have no default",
       "hidden": false,
       "name": "clear",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "When the default is offline, use this computer instead of trying the others",
       "hidden": false,
       "name": "no-fallback",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Try the others again when the default is offline (every online computer, oldest first, unless `--fallback` names an order)",
       "hidden": false,
       "name": "fallback-on",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "default",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Spaces to try, in this order, when the default is offline (names or ids, comma separated)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "fallback",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SPACES"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces default [OPTIONS] [SPACE]"
    },
    {
     "abstract": "Give a Space a new name; its id stays the same. Lowercase letters, digits and dashes, as at create. A Space you shared, or one of your computers provides, is renamed on the relay too, so your other devices and the people it is shared with see the new name. Only its owner can rename a Space",
     "after_help": "Examples:\n  cua spaces rename local:studio design-review\n  cua spaces rename relay:space-0123456789abcdef ci-runner",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id or name (as `cua spaces ls` shows)",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "The new name",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "rename",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces rename [OPTIONS] <SPACE> <NAME>"
    },
    {
     "abstract": "Change a setting of a Space. `--clipboard` says when its viewers may move the clipboard between this computer and the Space: `viewing` (the default) only while a viewer window is focused, when you paste or copy in it; `ask` asks for every transfer; `off` never. Viewers opened afterwards use it. An agent's own `computer_clipboard_*` tools act inside the Space and are not affected. `--volume` says what it sees of the Cua Volume: `own` (its own folder, the default) or `off`; it applies at once",
     "after_help": "Examples:\n  cua spaces set local:studio --clipboard off\n  cua spaces set local:studio --clipboard viewing\n  cua spaces set local:studio --volume off",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id or name (as `cua spaces ls` shows)",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "set",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "When viewers may move the clipboard: viewing, ask or off",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "clipboard",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "viewing|ask|off"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "What it sees of the Cua Volume: own or off",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "volume",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "own|off"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces set [OPTIONS] <SPACE>"
    },
    {
     "abstract": "Let someone in your team watch (viewer) or use (editor) a Space, through the relay. They open it as `relay:<computer>`. Sharing is for teams: you need a team, and they must be in it (or share with the whole team as `team:<id>`)",
     "after_help": "Examples:\n  cua spaces share local:studio [email protected]\n  cua spaces share local:studio [email protected] --role editor\n  cua spaces share relay:0123abcd4567ef89 acct-42 --role viewer\n  # The whole team, to watch\n  cua spaces share local:studio team:acme --role viewer\n  # From a script or agent: confirm with Touch ID or your password here\n  cua spaces share local:studio [email protected] --yes",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id, address or display name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Their email (verified by cua.ai) or account id, in your team; or `team:<id>` for the whole team",
       "hidden": false,
       "is_optional": false,
       "name": "WHO",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Confirm without a terminal prompt. Without a daemon the share happens at once. A running daemon still asks with Touch ID or your password on this computer; without a terminal, `--yes` says someone will answer there (otherwise the command fails at once instead of waiting for a prompt nobody sees)",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": "y",
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "share",
     "options": [
      {
       "aliases": [],
       "default_value": "viewer",
       "env": null,
       "help": "`viewer`: presence and a view-only stream. `editor`: full use",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "role",
       "possible_values": [
        "viewer",
        "editor"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "viewer | editor",
       "value_name": "ROLE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces share [OPTIONS] <SPACE> <WHO>"
    },
    {
     "abstract": "Stop sharing a Space with one account at once, or with everyone",
     "after_help": "Examples:\n  cua spaces unshare local:studio [email protected]\n  cua spaces unshare local:studio --all",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id, address or display name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Their email or account id",
       "hidden": false,
       "is_optional": true,
       "name": "WHO",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Stop sharing with everyone (the Space leaves the relay)",
       "hidden": false,
       "name": "all",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "unshare",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces unshare [OPTIONS] <SPACE> [WHO]"
    },
    {
     "abstract": "Who a Space is shared with, and who of them is connected now",
     "after_help": "Examples:\n  cua spaces shares local:studio\n  cua spaces shares local:studio --json",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id, address or display name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "shares",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces shares [OPTIONS] <SPACE>"
    },
    {
     "abstract": "Publish a Space on the relay for your other devices (a phone off this network): its own driver dials out, as `cua host setup` does for this computer. Nobody else gets in until you share it",
     "after_help": "Examples:\n  cua spaces relay-register local:studio",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id, address or display name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "relay-register",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces relay-register [OPTIONS] <SPACE>"
    },
    {
     "abstract": "Take a Space off the relay (every share with it ends). With a `relay:<computer>` id, removes that computer's record from your relay directory: a Space that registered itself (also after it was deleted), or a computer of yours that is gone. Only its owner can",
     "after_help": "Examples:\n  cua spaces relay-unregister local:studio\n  cua spaces relay-unregister relay:space-0123abcd4567ef89",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Space id, address or display name",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "relay-unregister",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua spaces relay-unregister [OPTIONS] <SPACE>"
    }
   ],
   "usage": "cua spaces [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Spaces in your own cloud account (AWS, Google Cloud, Hetzner, Modal): connect, status, test, disconnect, sweep; and pool hosts there (`cua cloud add aws`)",
   "after_help": "Examples:\n  cua cloud status\n  cua cloud connect aws --region us-west-2 --default\n  cua spaces create --on aws\n  cua cloud add aws --count 2 --type g6.xlarge\n  cua cloud sweep",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "cloud",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Your clouds: found credentials, the connected account and region, what each runs at what hourly cost, and what Cua created there",
     "after_help": "Examples:\n  cua cloud status\n  cua cloud status aws --json",
     "aliases": [
      "ls"
     ],
     "arguments": [
      {
       "default_value": null,
       "help": "Only this cloud (`aws`, `azure`, `gcp`, `hetzner`, `modal`)",
       "hidden": false,
       "is_optional": true,
       "name": "PROVIDER",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "status",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua cloud status [OPTIONS] [PROVIDER]"
    },
    {
     "abstract": "Connect a cloud account Spaces can be created in. Never prompts and is safe to run again: every run ends with a status, the next step and the command that verifies it. With --oidc, AWS and Google Cloud are linked without any key: Cua signs short-lived tokens that your account trusts. Azure is always linked that way. Without it, the cloud's own CLI sign-in on this device is used (Cua stores only the profile, region, project or environment names; Hetzner's API token goes to the Cua credential store)",
     "after_help": "How it ends (every run, also with --json):\n  status   connected | needs-trust | checking | waiting-for-approval | failed\n  next     run: the exact command to run next, or\n           open: a page a person opens (paste: what they paste there)\n           why: what it is for, in plain words\n  verify   the command that confirms it: cua cloud status <cloud>\n  checks   what the check found\nExit code: 0 connected, 10 the next step is yours (run it), 11 it waits on a\nperson (send them `next`), 1 error.\n\nAWS without a stored key (for agents: follow `next` until connected):\n  1. Ask the person for a monthly budget (US dollars), the region and the\n     largest machine, then run:\n       cua cloud connect aws --oidc --region us-west-2 --budget 200 --max-size 4x16\n  2. status needs-trust: send the person `next.open` (AWS CloudShell, or the\n     CloudFormation quick-create link) and `next.paste`. It creates one\n     stack, cua-spaces: an OIDC provider and the cua-spaces role, scoped to\n     what Cua tags cua-managed=true. No keys. Ask them for the 12-digit AWS\n     account id when it shows CREATE_COMPLETE.\n  3. Run `next.run` (the same command with --account-id <ID> --check). It\n     gets a check token, exchanges it with AWS STS and dry-runs a machine.\n     Nothing is created.\n  4. status connected: done. status waiting-for-approval: an agent made the\n     link (or raised a limit), so a person approves it in the Cua Spaces\n     app; then `cua cloud status aws` says connected.\n  Verify: cua cloud status aws\n\nHetzner and Modal: the API token is sealed to your devices (only devices of\nyour account open it; Cua's servers keep ciphertext). Ask the person for a\nbudget and the token (Hetzner: Read & Write, Cloud Console, Security, API\ntokens; Modal: `modal token new`, given as <token id>:<token secret>), then:\n  cua cloud connect hetzner --token-stdin --region fsn1 --budget 50 --max-size 4x8\n  It seals by default on a device with the account's pool keys when a\n  budget is given; --sealed insists on it, --no-sealed keeps the token on\n  this device only (as before). --sealed without a token seals the one this\n  device already has.\n  Verify: cua cloud status hetzner (its line says which devices can open it)\n\nGoogle Cloud without a stored key:\n  1. cua cloud connect gcp --oidc --project my-project --region us-central1 --budget 200 --max-size 4x16\n  2. status needs-trust: a person opens `next.open` (Google Cloud Shell with\n     Cua's trust script) and pastes `next.paste`: it creates the workload\n     identity pool cua, its provider, the role cuaSpaces and one binding. No\n     keys, no service accounts. It prints the project number. An agent on a\n     machine signed in to gcloud gets `next.run` instead (the same script).\n  3. Run `next.run` (with --project-number <N> --check): Google's STS\n     exchanges a check token and the role's permissions are checked.\n  Verify: cua cloud status gcp\n\nAzure (always without a stored key):\n  1. cua cloud connect azure --region westus2 --budget 200 --max-size 4x16\n  2. status needs-trust: a person opens `next.open` (Deploy to Azure) and\n     deploys into resource group cua-spaces: the cua-spaces managed identity\n     trusting Cua's tokens, with Virtual Machine Contributor and Network\n     Contributor on that group only. No keys. Ask for the outputs\n     subscriptionId, tenantId and clientId. An agent on a machine signed in\n     to the az CLI gets `next.run` instead.\n  3. Run `next.run` (with --subscription --tenant --client-id --check):\n     Microsoft Entra exchanges a check token, the resource group is read\n     and a machine is validated.\n  Verify: cua cloud status azure\n\nOther clouds use their own CLI sign-in on this device.\n`cua cloud trust <cloud>` prints the trust setup file (aws, gcp, azure).\nDocs for agents: https://cua.ai/docs/spaces/guides/connect-a-cloud\n\nExamples:\n  # AWS without a stored key: start, then check with the account id\n  cua cloud connect aws --oidc --region us-west-2 --budget 200 --max-size 4x16\n  cua cloud connect aws --oidc --region us-west-2 --budget 200 --max-size 4x16 --account-id 123456789012 --check\n  # Google Cloud without a stored key: start, then check with the project number\n  cua cloud connect gcp --oidc --project my-project --region us-central1 --budget 200\n  cua cloud connect gcp --oidc --project my-project --region us-central1 --budget 200 --project-number 123456789012 --check\n  # Azure: start, then check with the template's outputs\n  cua cloud connect azure --region westus2 --budget 200 --max-size 4x16\n  cua cloud connect azure --region westus2 --budget 200 --subscription 00000000-0000-0000-0000-000000000000 --tenant 11111111-1111-1111-1111-111111111111 --client-id 22222222-2222-2222-2222-222222222222 --check\n  # The cloud CLI's sign-in on this device, with the same limits\n  cua cloud connect aws --profile sandbox --region us-west-2 --budget 50 --default\n  cua cloud connect gcp --project my-project --region us-central1\n  cua cloud connect modal --environment spaces\n  # Hetzner: the project's API token on standard input, sealed to your devices\n  cua cloud connect hetzner --token-stdin --region fsn1 --budget 50 --max-size 4x8\n  # Modal: <token id>:<token secret> on standard input, sealed to your devices\n  cua cloud connect modal --token-stdin --budget 50\n  # Seal the Hetzner token this device already has\n  cua cloud connect hetzner --sealed --budget 50\n  # Spaces there delete themselves after 4 hours (default 8; 0: never)\n  cua cloud connect aws --ttl-hours 4",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "`aws`, `azure`, `gcp`, `hetzner` or `modal`",
       "hidden": false,
       "is_optional": false,
       "name": "PROVIDER",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Hetzner or Modal: read the API token from stdin (Hetzner: a Read & Write project token, otherwise `HCLOUD_TOKEN`, the saved token or the hcloud CLI's context; Modal: `<token id>:<token secret>`). Once the checks pass it is sealed to your devices, or with --no-sealed saved in this device's Cua credential store (Hetzner)",
       "hidden": false,
       "name": "token-stdin",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Also make it the default location (`default.on`)",
       "hidden": false,
       "name": "default",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Link without a stored key: Cua's issuer signs 15-minute tokens your account trusts (AWS, Google Cloud; Azure always)",
       "hidden": false,
       "name": "oidc",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Hetzner, Modal: seal the API token to your devices (the token given on stdin, else the one this device has). The default when this device has the account's pool keys and a budget is given",
       "hidden": false,
       "name": "sealed",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Hetzner: keep the API token on this device only (in the Cua credential store), as before sealing",
       "hidden": false,
       "name": "no-sealed",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "With --oidc (and Azure): prove the link works (a check token, the exchange with the cloud, a dry run, permission check or validate; nothing is created) and save it",
       "hidden": false,
       "name": "check",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "connect",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "AWS profile (`~/.aws/config`) or Modal profile (`~/.modal.toml`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "profile",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PROFILE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "AWS, Google Cloud or Azure region, or Hetzner location (default `fsn1`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "region",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REGION"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Google Cloud zone (default: the region's `-a` zone)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "zone",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ZONE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Google Cloud project (default: `gcloud config get project`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "project",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PROJECT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Modal environment (default: the profile's)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "environment",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ENVIRONMENT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Delete each Space there after this many hours (default 8; 0: never; Modal caps a sandbox at 24; a Hetzner server shuts itself down then and `cua cloud sweep --delete` removes it)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "ttl-hours",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "TTL_HOURS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The most Cua may spend there per calendar month, in US dollars. New machines are refused once it is reached; stopping and deleting always works. Needed with --oidc",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "budget",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "number",
       "value_name": "USD"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The largest machine Cua may create there: vCPUs x GB, for example 4x16",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-size",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "VCPUxGB"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --oidc: the 12-digit AWS account id the trust stack is in",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "account-id",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ID"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --oidc: the role ARN, only if it is not named cua-spaces",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "role-arn",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ARN"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Google Cloud with --oidc: the project number (the trust script prints it)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "project-number",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NUMBER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Google Cloud with --oidc: a service account to act as (default: none, the federated identity calls Google directly)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "service-account",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "EMAIL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Azure: the subscription id (the template's subscriptionId)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "subscription",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ID"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Azure: the Microsoft Entra tenant id (the template's tenantId)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "tenant",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ID"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Azure: the cua-spaces managed identity's client id (the template's clientId)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "client-id",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ID"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Azure: the resource group Cua works in, the only one its roles reach (default cua-spaces)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "resource-group",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua cloud connect [OPTIONS] <PROVIDER>"
    },
    {
     "abstract": "Approve what an agent asked for on a cloud: its link, or a higher budget or larger machines. For a person only (refused in an agent's shell). With --deny, decline it: the limits in force stay, and a link never approved is disconnected",
     "after_help": "Examples:\n  cua cloud status aws\n  cua cloud approve aws\n  cua cloud approve aws --deny",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "`aws`, `gcp`, `hetzner` or `modal`",
       "hidden": false,
       "is_optional": false,
       "name": "PROVIDER",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Decline instead of approving",
       "hidden": false,
       "name": "deny",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "approve",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua cloud approve [OPTIONS] <PROVIDER>"
    },
    {
     "abstract": "Print the file that makes a cloud trust Cua's tokens (no keys): the AWS CloudFormation stack, the Google Cloud trust script, or the Azure resource group template. `cua cloud connect` says when and how to run it",
     "after_help": "Examples:\n  cua cloud trust gcp > cua-trust.sh\n  cua cloud trust azure > cua-spaces.json\n  cua cloud trust aws > cua-spaces.yaml",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "`aws`, `gcp` or `azure`",
       "hidden": false,
       "is_optional": false,
       "name": "CLOUD",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "trust",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua cloud trust [OPTIONS] <CLOUD>"
    },
    {
     "abstract": "Check a cloud account without creating anything: credentials, permissions (by dry run), quota, the region and machine types",
     "after_help": "Examples:\n  cua cloud test aws\n  cua cloud test gcp --project my-project",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "`aws`, `azure`, `gcp`, `hetzner` or `modal`",
       "hidden": false,
       "is_optional": false,
       "name": "PROVIDER",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Hetzner or Modal: read the API token from stdin (Hetzner: a Read & Write project token, otherwise `HCLOUD_TOKEN`, the saved token or the hcloud CLI's context; Modal: `<token id>:<token secret>`). Once the checks pass it is sealed to your devices, or with --no-sealed saved in this device's Cua credential store (Hetzner)",
       "hidden": false,
       "name": "token-stdin",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "test",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "AWS profile (`~/.aws/config`) or Modal profile (`~/.modal.toml`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "profile",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PROFILE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "AWS, Google Cloud or Azure region, or Hetzner location (default `fsn1`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "region",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REGION"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Google Cloud zone (default: the region's `-a` zone)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "zone",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ZONE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Google Cloud project (default: `gcloud config get project`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "project",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PROJECT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Modal environment (default: the profile's)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "environment",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ENVIRONMENT"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua cloud test [OPTIONS] <PROVIDER>"
    },
    {
     "abstract": "Forget a connected cloud. Refused while Spaces Cua created there still run (they would keep billing unseen); add --delete to delete everything Cua created there first, then disconnect",
     "after_help": "Examples:\n  cua cloud disconnect aws\n  # delete everything Cua created in the account, then disconnect\n  cua cloud disconnect aws --delete",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "`aws`, `azure`, `gcp`, `hetzner` or `modal`",
       "hidden": false,
       "is_optional": false,
       "name": "PROVIDER",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Delete everything Cua created there first; disconnect only once the cloud confirms nothing is left",
       "hidden": false,
       "name": "delete",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "disconnect",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua cloud disconnect [OPTIONS] <PROVIDER>"
    },
    {
     "abstract": "What Cua did in your clouds: connects, disconnects, and every resource recorded, created, confirmed and deleted (by you, a sweep, the automatic sweep or disconnect --delete). Newest last. Never shows a secret",
     "after_help": "Examples:\n  cua cloud audit\n  cua cloud audit --limit 200\n  cua cloud audit --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "audit",
     "options": [
      {
       "aliases": [],
       "default_value": "50",
       "env": null,
       "help": "How many of the newest entries (default 50)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "limit",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "LIMIT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only this cloud (`aws`, `gcp`, `hetzner`, `modal`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cloud",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "CLOUD"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua cloud audit [OPTIONS]"
    },
    {
     "abstract": "What the machines Cua created in your clouds cost: each one's list price times how long it ran, by Space, agent, UTC day or cloud. An estimate; the cloud's own bill is the final word",
     "after_help": "Examples:\n  cua cloud cost\n  cua cloud cost --by agent --since 2026-10-01\n  cua cloud cost --cloud aws --by day --format csv > aws-october.csv",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "cost",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only this cloud (`aws`, `gcp`, `hetzner`, `modal`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cloud",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "CLOUD"
      },
      {
       "aliases": [],
       "default_value": "space",
       "env": null,
       "help": "One row per `space`, `agent`, `day` or `cloud`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "by",
       "possible_values": [
        "space",
        "agent",
        "day",
        "cloud"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "space | agent | day | cloud",
       "value_name": "BY"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The first day counted, YYYY-MM-DD (UTC). Default: the first of this month",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "since",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "YYYY-MM-DD"
      },
      {
       "aliases": [],
       "default_value": "table",
       "env": null,
       "help": "`table`, `csv` (header: key,usd,hours,machines) or `json`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "format",
       "possible_values": [
        "table",
        "csv",
        "json"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "table | csv | json",
       "value_name": "FORMAT"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua cloud cost [OPTIONS]"
    },
    {
     "abstract": "Find what Cua left in your clouds: expired Spaces and resources whose Space is gone (with --all, every Cua resource). Lists them unless --delete. Only resources Cua tagged and recorded are ever touched",
     "after_help": "Examples:\n  cua cloud sweep\n  cua cloud sweep aws --delete\n  cua cloud sweep --all --delete",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Only this cloud",
       "hidden": false,
       "is_optional": true,
       "name": "PROVIDER",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Delete what it finds (default: list only)",
       "hidden": false,
       "name": "delete",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Include Cua resources that have not expired (every Space there)",
       "hidden": false,
       "name": "all",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "sweep",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua cloud sweep [OPTIONS] [PROVIDER]"
    },
    {
     "abstract": "Add hosts in your cloud to your pool: computers made for Cua work that join by themselves (`cua cloud add aws`)",
     "after_help": "Examples:\n  cua cloud add aws --count 2 --type g6.xlarge --ttl-hours 6\n  cua cloud add aws --list\n  cua cloud add aws --down",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "add",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [
      {
       "abstract": "EC2 hosts in your connected AWS account (`cua cloud connect aws`) that join your pool by themselves: Ubuntu 24.04 for CPU types, the AWS Deep Learning Base GPU image for g*/p* types. Each one is dedicated (made only for this work: jobs run in its own Space, with its GPU) and powers off (and is terminated) at its TTL",
       "after_help": "Examples:\n  cua cloud add aws --count 2 --type c7i.large\n  cua cloud add aws --count 2 --type g6.xlarge --ttl-hours 6 --tag team=ml\n  cua cloud add aws --list\n  cua cloud add aws --down",
       "aliases": [],
       "arguments": [],
       "flags": [
        {
         "aliases": [],
         "default_value": false,
         "env": null,
         "help": "Return once the instances exist, without waiting for them to join",
         "hidden": false,
         "name": "no-wait",
         "repeatable": false,
         "short_name": null,
         "takes_value": false
        },
        {
         "aliases": [],
         "default_value": false,
         "env": null,
         "help": "The hosts `cua cloud add aws` made, their state and whether they joined",
         "hidden": false,
         "name": "list",
         "repeatable": false,
         "short_name": null,
         "takes_value": false
        },
        {
         "aliases": [],
         "default_value": false,
         "env": null,
         "help": "Terminate the hosts `cua cloud add aws` made (all, or `--name`) and remove them from your pool",
         "hidden": false,
         "name": "down",
         "repeatable": false,
         "short_name": null,
         "takes_value": false
        }
       ],
       "hidden": false,
       "hidden_aliases": [],
       "name": "aws",
       "options": [
        {
         "aliases": [],
         "default_value": "1",
         "env": null,
         "help": "How many hosts",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "count",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "integer",
         "value_name": "COUNT"
        },
        {
         "aliases": [],
         "default_value": "c7i.large",
         "env": null,
         "help": "The EC2 instance type. GPU types (g*, p*) only when named here",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "type",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "TYPE"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Region (default: the connected one)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "region",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "REGION"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Hours until each host powers off and is terminated (default: the connection's, 8)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "ttl-hours",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "integer",
         "value_name": "TTL_HOURS"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "An extra `key=value` tag on every resource. Repeatable",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "tag",
         "possible_values": [],
         "repeatable": true,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "KEY=VALUE"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Root disk in GiB (default 60 for CPU types, 100 for GPU types)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "disk-gb",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "integer",
         "value_name": "DISK_GB"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "With --down: only this host (`aws-3`)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "name",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "NAME"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua cloud add aws [OPTIONS]"
      }
     ],
     "usage": "cua cloud add [OPTIONS] <COMMAND>"
    },
    {
     "abstract": "What the elastic pool would do for some Spaces: where each goes (your devices first, then hosts with room, then new cloud machines at the least cost) and what it costs. Pins are constraints of the same solve. With --apply, adds the machines (then create the Spaces with --on auto)",
     "after_help": "Examples:\n  cua cloud plan --count 256 --image linux:24.04-slim --caller batch --duration-secs 1800\n  cua cloud plan --count 20 --provider aws --instance-type c7g.xlarge --json\n  cua cloud plan --count 64 --no-scale\n  cua cloud plan --count 32 --apply",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Keep them on one machine (forks of one checkpoint)",
       "hidden": false,
       "name": "together",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Add no machines",
       "hidden": false,
       "name": "no-scale",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Only your own devices",
       "hidden": false,
       "name": "devices-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Add the machines the plan needs",
       "hidden": false,
       "name": "apply",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "plan",
     "options": [
      {
       "aliases": [],
       "default_value": "1",
       "env": null,
       "help": "How many Spaces",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "count",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "COUNT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Image (default linux)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "image",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "IMAGE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "`container`, `vm` or `microvm`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "kind",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "KIND"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "vCPUs each",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cpus",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "CPUS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Memory each, MiB",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "memory-mb",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MEMORY_MB"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "`interactive`, `batch`, `compat` or `persistent_agent`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "caller",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "CALLER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Expected lifetime, seconds",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "duration-secs",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "DURATION_SECS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only this cloud",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "provider",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PROVIDER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only this region",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "region",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REGION"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only this machine type",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "instance-type",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "INSTANCE_TYPE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Exactly this many new machines",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "hosts",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "HOSTS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A $/hour cap for this plan",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-per-hour",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "number",
       "value_name": "MAX_USD_PER_HOUR"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua cloud plan [OPTIONS]"
    },
    {
     "abstract": "The hosts the elastic pool runs in your clouds: add them by hand (pinned: the scaler never removes them), list or remove them",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "hosts",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [
      {
       "abstract": "The hosts with their state and cost",
       "after_help": "Examples:\n  cua cloud hosts ls",
       "aliases": [
        "ls"
       ],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "list",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua cloud hosts list [OPTIONS]"
      },
      {
       "abstract": "Add hosts by hand (pinned: never removed by the scaler)",
       "after_help": "Examples:\n  cua cloud hosts add --provider hetzner --type cax41 --region fsn1\n  cua cloud hosts add --provider aws --type c7g.xlarge --count 2 --ttl-hours 4",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "add",
       "options": [
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "`aws`, `gcp` or `hetzner`",
         "hidden": false,
         "is_optional": false,
         "multiple_values": false,
         "name": "provider",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "PROVIDER"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Machine type (`cua cloud plan --json` lists the offers)",
         "hidden": false,
         "is_optional": false,
         "multiple_values": false,
         "name": "type",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "INSTANCE_TYPE"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Region (default: the connection's)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "region",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "REGION"
        },
        {
         "aliases": [],
         "default_value": "1",
         "env": null,
         "help": "How many",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "count",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "integer",
         "value_name": "COUNT"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Hours until each ends on its own (1 to 168, default 24)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "ttl-hours",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "integer",
         "value_name": "TTL_HOURS"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua cloud hosts add [OPTIONS] --provider <PROVIDER> --type <INSTANCE_TYPE>"
      },
      {
       "abstract": "Remove hosts this home added (their Spaces end)",
       "after_help": "Examples:\n  cua cloud hosts rm hetzner-1\n  cua cloud hosts rm aws-1 aws-2",
       "aliases": [
        "rm"
       ],
       "arguments": [
        {
         "default_value": null,
         "help": "Their names (`hetzner-1`)",
         "hidden": false,
         "is_optional": false,
         "name": "NAMES",
         "possible_values": [],
         "repeatable": true,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "remove",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua cloud hosts remove [OPTIONS] <NAMES>..."
      }
     ],
     "usage": "cua cloud hosts [OPTIONS] <COMMAND>"
    },
    {
     "abstract": "The elastic pool's budget: a $/hour cap, a monthly cap, the autoscale switch. Without flags, shows them and what the clouds cost now",
     "after_help": "Examples:\n  cua cloud budget\n  cua cloud budget --max-per-hour 2 --monthly 40\n  cua cloud budget --autoscale off",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "budget",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Most USD per hour your clouds may cost at once",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-per-hour",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "number",
       "value_name": "MAX_USD_PER_HOUR"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Most USD per calendar month on elastic hosts",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "monthly",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "number",
       "value_name": "MONTHLY_USD"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "`on` or `off`: add and remove cloud hosts by itself. Off, you manage machines: `--on auto` uses only what runs, and `--on <cloud>` gives each Space a cloud machine of its own",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "autoscale",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "AUTOSCALE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Most hosts one placement adds",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-new-hosts",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MAX_NEW_HOSTS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "`on` or `off`: keep an idle host warm when demand predicts a Space soon",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "warm",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "WARM"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "`on` or `off`: let one small VM Space buy a KVM metal host (dollars an hour). Off, such a request is refused and says so",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "allow-metal",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ALLOW_METAL"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua cloud budget [OPTIONS]"
    },
    {
     "abstract": "Run the elastic pool's scale-in pass now (the daemon runs one every 30 s): idle hosts go at the end of their paid time",
     "after_help": "Examples:\n  cua cloud reconcile\n  cua cloud reconcile --watch",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Keep running a pass every 30 s",
       "hidden": false,
       "name": "watch",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "reconcile",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua cloud reconcile [OPTIONS]"
    }
   ],
   "usage": "cua cloud [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "This device as a client of your cua.ai account on the relay: enroll (second factor), approve other devices, list, rename, revoke, and the audit log of who accessed what",
   "after_help": "Examples:\n  cua devices enroll\n  cua devices approve K7QX-M2RP\n  cua devices ls\n  cua devices audit",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "devices",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "This device: enrolled, waiting for approval, or not enrolled",
     "after_help": "Examples:\n  cua devices status",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "status",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Relay URL (default $CUA_RELAY_URL, else the CUA_ENV relay, https://relay.cua.ai in production)",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "relay",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RELAY"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua devices status [OPTIONS]"
    },
    {
     "abstract": "Enroll this device. Right after a fresh `cua auth login` it enrolls at once (and replaces this computer's older device key, if any); otherwise it shows a one-time code to approve from an enrolled device (`cua devices approve <code>` or the Cua Spaces app)",
     "after_help": "Examples:\n  cua devices enroll\n  cua devices enroll --name \"work laptop\" --wait",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Wait (up to 10 minutes) until an enrolled device approves",
       "hidden": false,
       "name": "wait",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "enroll",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Display name (default: the host name)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "name",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Relay URL",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "relay",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RELAY"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua devices enroll [OPTIONS]"
    },
    {
     "abstract": "Approve a new device (or re-verify an expired one) from this enrolled device, by the code it shows or by its id",
     "after_help": "Examples:\n  cua devices approve K7QX-M2RP\n  cua devices approve dev_0123456789abcdef01234567",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The one-time code the new device shows, or its device id (`dev_…`, from `cua devices ls`)",
       "hidden": false,
       "is_optional": true,
       "name": "CODE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not ask for confirmation",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "approve",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Or the device id (`cua devices ls`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "device",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "DEVICE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Relay URL",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "relay",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RELAY"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua devices approve [OPTIONS] [CODE]"
    },
    {
     "abstract": "Your signed-in machines and their state",
     "after_help": "Examples:\n  cua devices ls\n  cua devices ls --json",
     "aliases": [
      "list"
     ],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "ls",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Relay URL",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "relay",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RELAY"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua devices ls [OPTIONS]"
    },
    {
     "abstract": "Rename a device",
     "after_help": "Examples:\n  cua devices rename dev_0123456789abcdef01234567 \"work phone\"",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Device id",
       "hidden": false,
       "is_optional": false,
       "name": "ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "New name",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "rename",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Relay URL",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "relay",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RELAY"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua devices rename [OPTIONS] <ID> <NAME>"
    },
    {
     "abstract": "Revoke a device: it can no longer list or reach your computers",
     "after_help": "Examples:\n  cua devices revoke dev_0123456789abcdef01234567",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Device id",
       "hidden": false,
       "is_optional": false,
       "name": "ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not ask for confirmation",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "revoke",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Relay URL",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "relay",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RELAY"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua devices revoke [OPTIONS] <ID>"
    },
    {
     "abstract": "Who accessed what, and when: enrollments, device sessions, computer access (yours and by accounts you share with), sharing changes",
     "after_help": "Examples:\n  cua devices audit\n  cua devices audit --limit 20 --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "audit",
     "options": [
      {
       "aliases": [],
       "default_value": "50",
       "env": null,
       "help": "Newest events to show",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "limit",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "LIMIT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Relay URL",
       "hidden": true,
       "is_optional": true,
       "multiple_values": false,
       "name": "relay",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "RELAY"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua devices audit [OPTIONS]"
    }
   ],
   "usage": "cua devices [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Teams (organizations of your cua.ai account) share computers with every member and their agents. Owners and admins invite by email, approve member devices and add computers",
   "after_help": "Examples:\n  cua team create AIGIS\n  cua team invite AIGIS [email protected]\n  cua team add-machine AIGIS local:build-box\n  cua team approve AIGIS dev_0123456789abcdef01234567\n  cua team show AIGIS",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "team",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Create a team; you are its owner. Buy Teams for it at app.cua.ai to add computers",
     "after_help": "Examples:\n  cua team create \"AIGIS\"",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Team name",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "create",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua team create [OPTIONS] <NAME>"
    },
    {
     "abstract": "Your teams",
     "after_help": "Examples:\n  cua team ls\n  cua team ls --json",
     "aliases": [
      "list"
     ],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "ls",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua team ls [OPTIONS]"
    },
    {
     "abstract": "A team: plan, members, computers, open invites and devices",
     "after_help": "Examples:\n  cua team show AIGIS",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Team id, alias or name",
       "hidden": false,
       "is_optional": false,
       "name": "TEAM",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "show",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua team show [OPTIONS] <TEAM>"
    },
    {
     "abstract": "Invite someone by email: cua.ai emails them an invitation. Manage invites at app.cua.ai/team",
     "after_help": "Examples:\n  cua team invite AIGIS [email protected]\n  cua team invite AIGIS [email protected] --role admin",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Team id, alias or name",
       "hidden": false,
       "is_optional": false,
       "name": "TEAM",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Their email",
       "hidden": false,
       "is_optional": false,
       "name": "EMAIL",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "invite",
     "options": [
      {
       "aliases": [],
       "default_value": "member",
       "env": null,
       "help": "`member` or `admin` (only the owner invites admins)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "role",
       "possible_values": [
        "member",
        "admin"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "member | admin",
       "value_name": "ROLE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua team invite [OPTIONS] <TEAM> <EMAIL>"
    },
    {
     "abstract": "After accepting an emailed invitation: take the role it offered. Run `cua auth login` first so your session lists the team",
     "after_help": "Examples:\n  cua team join AIGIS",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Team id, alias or name",
       "hidden": false,
       "is_optional": false,
       "name": "TEAM",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "join",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua team join [OPTIONS] <TEAM>"
    },
    {
     "abstract": "Leave a team",
     "after_help": "Examples:\n  cua team leave AIGIS",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Team id, alias or name",
       "hidden": false,
       "is_optional": false,
       "name": "TEAM",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "leave",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua team leave [OPTIONS] <TEAM>"
    },
    {
     "abstract": "Remove a member (owner or admin; admins cannot remove admins)",
     "after_help": "Examples:\n  cua team remove-member AIGIS [email protected]",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Team id, alias or name",
       "hidden": false,
       "is_optional": false,
       "name": "TEAM",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Their email or account id",
       "hidden": false,
       "is_optional": false,
       "name": "WHO",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "remove-member",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua team remove-member [OPTIONS] <TEAM> <WHO>"
    },
    {
     "abstract": "Make a member an admin, or an admin a member (owner)",
     "after_help": "Examples:\n  cua team set-role AIGIS [email protected] admin",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Team id, alias or name",
       "hidden": false,
       "is_optional": false,
       "name": "TEAM",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Their email or account id",
       "hidden": false,
       "is_optional": false,
       "name": "WHO",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "`member` or `admin`",
       "hidden": false,
       "is_optional": false,
       "name": "ROLE",
       "possible_values": [
        "member",
        "admin"
       ],
       "repeatable": false,
       "type": "member | admin"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "set-role",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua team set-role [OPTIONS] <TEAM> <WHO> <ROLE>"
    },
    {
     "abstract": "Member devices and whether they may open team computers",
     "after_help": "Examples:\n  cua team devices AIGIS",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Team id, alias or name",
       "hidden": false,
       "is_optional": false,
       "name": "TEAM",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "devices",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua team devices [OPTIONS] <TEAM>"
    },
    {
     "abstract": "Approve a member device so it can open team computers",
     "after_help": "Examples:\n  cua team approve AIGIS dev_0123456789abcdef01234567",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Team id, alias or name",
       "hidden": false,
       "is_optional": false,
       "name": "TEAM",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Device id (`cua team devices`)",
       "hidden": false,
       "is_optional": false,
       "name": "DEVICE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "approve",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua team approve [OPTIONS] <TEAM> <DEVICE>"
    },
    {
     "abstract": "Decline a member device (it can no longer open team computers)",
     "after_help": "Examples:\n  cua team deny AIGIS dev_0123456789abcdef01234567",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Team id, alias or name",
       "hidden": false,
       "is_optional": false,
       "name": "TEAM",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Device id",
       "hidden": false,
       "is_optional": false,
       "name": "DEVICE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "deny",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua team deny [OPTIONS] <TEAM> <DEVICE>"
    },
    {
     "abstract": "Ask the team's admins to approve this device",
     "after_help": "Examples:\n  cua team request AIGIS",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Team id, alias or name",
       "hidden": false,
       "is_optional": false,
       "name": "TEAM",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "request",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua team request [OPTIONS] <TEAM>"
    },
    {
     "abstract": "Make a Space (or a computer you host) a team computer: every member and their agents see it and can open it. Macs, Linux and Windows computers all can. Each Space is added on its own: adding a host does not add the Spaces it provides",
     "after_help": "Examples:\n  cua team add-machine AIGIS local:build-box\n  cua team add-machine AIGIS relay:0123abcd4567ef89 --yes",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Team id, alias or name",
       "hidden": false,
       "is_optional": false,
       "name": "TEAM",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Space id or name (`relay:<id>` for a computer you host)",
       "hidden": false,
       "is_optional": false,
       "name": "SPACE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Confirm without a prompt",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "add-machine",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua team add-machine [OPTIONS] <TEAM> <SPACE>"
    },
    {
     "abstract": "Take a computer off the team",
     "after_help": "Examples:\n  cua team remove-machine AIGIS relay:0123abcd4567ef89",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Team id, alias or name",
       "hidden": false,
       "is_optional": false,
       "name": "TEAM",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "The computer (`relay:<id>` or its id, as `cua team show` lists it)",
       "hidden": false,
       "is_optional": false,
       "name": "COMPUTER",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "remove-machine",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua team remove-machine [OPTIONS] <TEAM> <COMPUTER>"
    },
    {
     "abstract": "The team's audit log. Audit export is coming soon; for now see the account app (app.cua.ai)",
     "after_help": "Examples:\n  cua team audit AIGIS",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Team id, alias or name",
       "hidden": false,
       "is_optional": false,
       "name": "TEAM",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "audit",
     "options": [
      {
       "aliases": [],
       "default_value": "50",
       "env": null,
       "help": "Newest events to show (when export arrives)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "limit",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "LIMIT"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua team audit [OPTIONS] <TEAM>"
    },
    {
     "abstract": "Delete a team (owner; cancel its subscription first). Its computers stay yours",
     "after_help": "Examples:\n  cua team delete AIGIS --yes",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Team id, alias or name",
       "hidden": false,
       "is_optional": false,
       "name": "TEAM",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not ask for confirmation",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "delete",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua team delete [OPTIONS] <TEAM>"
    }
   ],
   "usage": "cua team [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Cua CI, GitHub Actions jobs on Cua Spaces: each job runs in a fresh Space (a macOS VM or a Linux container or VM) registered with a just-in-time runner, then deleted. Connect this computer, then use `runs-on: cua`. An experiment: `cua experiments enable ci-runners`",
   "after_help": "Examples:\n  cua ci connect\n  cua ci status\n  cua ci logs\n  cua ci config --budget 50\n  cua ci disconnect",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "ci",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Connect this computer to Cua CI: sign in, install the hosted GitHub app on your organization (you pick the repositories), and serve jobs here. Prints the `runs-on` line for your workflows",
     "after_help": "Examples:\n  # The usual way: sign in, install the app on GitHub in your browser, serve jobs\n  cua ci connect\n  # Serve only these repositories, and open a pull request that changes their workflows\n  cua ci connect --allow acme/app --allow acme/api --open-pr\n  # A headless Mac over SSH: print the links instead of opening a browser\n  cua ci connect --no-browser\n  # Your own GitHub App with its key in a 0600 file (self-hosting, no Cua service)\n  cua ci connect --own-app --org trycua --app-id 123456 --key-file ~/.cua/ci/github-app.pem",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Use your own GitHub App (its key kept in the keychain or a file only you can read) and no Cua service, for self-hosting. `--org` or `--repo` and the App options below go with it",
       "hidden": false,
       "name": "own-app",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Open a pull request in each served repository that points its workflows at Cua CI (it uses your own GitHub sign-in: `gh auth login`, or GH_TOKEN). Nothing is pushed to the default branch",
       "hidden": false,
       "name": "open-pr",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not ask",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": "y",
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Print the sign-in and GitHub links instead of opening a browser",
       "hidden": false,
       "name": "no-browser",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Refuse to start runners where egress cannot be enforced (macOS VMs today) instead of starting them without it",
       "hidden": false,
       "name": "require-egress",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Read the App's private key from stdin",
       "hidden": false,
       "name": "private-key-stdin",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Read a GitHub token from stdin instead of using an App",
       "hidden": false,
       "name": "token-stdin",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Write the configuration without installing the service (run `cua ci serve` yourself)",
       "hidden": false,
       "name": "no-service",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not check the credential with GitHub",
       "hidden": false,
       "name": "no-verify",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "connect",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A Cua organization to connect (id, alias or name); default: your own account",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "team",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TEAM"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Serve jobs of this repository (`owner/name`, repeatable). Default: the ones you pick, or ask",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "allow",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REPO"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --open-pr: change only these workflow files",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "workflows",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PATH"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "macOS jobs at once on this computer (default 2 on Apple silicon; at most 2 per Mac)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "macos-slots",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MACOS_SLOTS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Linux jobs at once on this computer (default: one per 4 cores)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "linux-slots",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "LINUX_SLOTS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The image macOS jobs start from",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "macos-image",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "IMAGE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The image Linux jobs start from",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "linux-image",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "IMAGE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The name shown in `cua ci status` (default: this computer's name)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "name",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NAME"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Also add a cloud right away (`aws`, `gcp`, `azure`, `hetzner`, `modal`, `macstadium`): the same as `cua ci add` after connecting. Not in this build yet",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cloud",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TARGET"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The GitHub organization: the one to install the Cua CI app on, or with --own-app the organization to register runners for (`--org trycua`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "org",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ORG"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --own-app: register runners for one repository (`--repo owner/name`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "repo",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REPO"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The pool's name (default: the organization, or owner-name)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "pool",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "POOL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The organization runner group runners join (default: the organization's default group). Restrict it to selected repositories at GitHub",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "group",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "GROUP"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Labels besides self-hosted, the OS, the architecture and cua (comma-separated)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "labels",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "LABELS"
      },
      {
       "aliases": [],
       "default_value": "ghcr.io/trycua/macos:26",
       "env": null,
       "help": "The image each runner's Space starts from: a registry image, or `checkpoint:<name>` (a golden image saved with `cua sb checkpoint`, with --os)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "image",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "IMAGE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The image's OS, `macos` or `linux` (default: from the image's name; needed for a checkpoint)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "os",
       "possible_values": [
        "macos",
        "linux"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "macos | linux",
       "value_name": "OS"
      },
      {
       "aliases": [],
       "default_value": "local",
       "env": null,
       "help": "Where job Spaces run: `local` (this computer), `auto` (any of your computers) or `host:<computer>`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "on",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ON"
      },
      {
       "aliases": [],
       "default_value": "2",
       "env": null,
       "help": "At most this many runners at once (macOS on one computer: at most 2)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MAX"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Idle runners to keep ready (default: --max)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "warm",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "WARM"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "vCPUs per runner (default for macOS here: half this Mac's cores per runner)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "cpus",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "CPUS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Memory per runner in MiB (default for macOS here: this Mac's memory less 8 GiB split between the runners, at most 8 GiB)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "memory-mb",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "MEMORY_MB"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Disk per runner in GiB (default: the image's)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "disk-gb",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "DISK_GB"
      },
      {
       "aliases": [],
       "default_value": "6h",
       "env": null,
       "help": "Stop a job that runs longer (its Space is deleted)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "job-timeout",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "JOB_TIMEOUT"
      },
      {
       "aliases": [],
       "default_value": "60m",
       "env": null,
       "help": "Replace an idle runner after this long",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "idle-timeout",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "IDLE_TIMEOUT"
      },
      {
       "aliases": [],
       "default_value": "deny-private",
       "env": null,
       "help": "`deny-private` (default): runner Spaces cannot reach private, tailnet, link-local or unique-local addresses; `off`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "egress",
       "possible_values": [
        "deny-private",
        "off"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "deny-private | off",
       "value_name": "EGRESS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The GitHub App's id",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "app-id",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "APP_ID"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The App's installation id (default: looked up)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "installation-id",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "INSTALLATION_ID"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The App's private key (.pem). Delete the file afterwards: the key is kept in the keychain",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "private-key-file",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "path",
       "value_name": "PRIVATE_KEY_FILE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Keep the App's private key in this file instead of the keychain (it must be yours, mode 0600). For a headless host or one set up over SSH, whose login keychain cannot be used. The pool reads it on every start; nothing is copied",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "key-file",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "path",
       "value_name": "PATH"
      },
      {
       "aliases": [],
       "default_value": "keychain",
       "env": null,
       "help": "Where the credential is kept: `keychain` (the login keychain on macOS) or `file` (a file only you can read under ~/.cua/ci/secrets/; for a Mac set up over SSH, whose keychain is locked)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "secret-store",
       "possible_values": [
        "keychain",
        "file"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "keychain | file",
       "value_name": "SECRET_STORE"
      },
      {
       "aliases": [],
       "default_value": "https://api.github.com",
       "env": null,
       "help": "The GitHub REST API (GitHub Enterprise Server: `https://HOST/api/v3`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "api-url",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "API_URL"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua ci connect [OPTIONS]"
    },
    {
     "abstract": "Add capacity: a computer over SSH. `host USER@ADDRESS` installs and joins any rented or owned computer, which then serves jobs as one more computer. Cloud accounts are not in this build yet",
     "after_help": "Examples:\n  cua ci add host [email protected]",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "`aws`, `gcp`, `azure`, `hetzner`, `modal`, `macstadium` or `host`",
       "hidden": false,
       "is_optional": false,
       "name": "TARGET",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "For `host`: its SSH address (`USER@ADDRESS`)",
       "hidden": false,
       "is_optional": true,
       "name": "ADDRESS",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "AWS: Mac hosts for macOS jobs (billed at least 24 hours a host)",
       "hidden": false,
       "name": "macos",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not ask",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": "y",
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Print links instead of opening a browser",
       "hidden": false,
       "name": "no-browser",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Hetzner, Modal, MacStadium: read the token from stdin",
       "hidden": false,
       "name": "token-stdin",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "host: read the private key from stdin",
       "hidden": false,
       "name": "key-stdin",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "add",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Monthly budget in dollars (default: asked once, 50)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "budget",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "number",
       "value_name": "DOLLARS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Hard cap in dollars an hour (default: a twentieth of the budget)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-per-hour",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "number",
       "value_name": "DOLLARS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Fix how many free slots are kept ready so a job does not wait for a computer to boot (0: never). Without it Cua chooses from your own job history, inside the budget. Never on Mac hosts",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "warm",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "SLOTS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "What Cua optimizes when it chooses: `cheapest` (lowest bill), `balanced` (default) or `fastest` (shortest starts). The budget stays a hard limit for all three",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "goal",
       "possible_values": [
        "cheapest",
        "balanced",
        "fastest"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "cheapest | balanced | fastest",
       "value_name": "GOAL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Region or location (default: the nearest one)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "region",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REGION"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "AWS: the 12-digit account id (found automatically when `aws` is signed in on this computer)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "account-id",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ID"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Google Cloud: the project number the trust step prints",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "project-number",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NUMBER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Azure: the subscription id",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "subscription",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ID"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Azure: the Microsoft Entra tenant id",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "tenant",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ID"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Azure: the managed identity's client id",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "client-id",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "ID"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "host: a private key file for the SSH login. With it Cua manages the computer itself (installs and removes its own units over SSH, keeps the key in this computer's keychain, runs jobs in isolated Spaces on it). Without it the computer signs in to Cua on its own",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "key",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "FILE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "host: the computer's public host key as `<type> <base64>` (default: fetched with ssh-keyscan and confirmed by its fingerprint)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "host-key",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "KEY"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "host: what the computer costs a month in dollars when rented (default: yours, free)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "monthly",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "number",
       "value_name": "DOLLARS"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua ci add [OPTIONS] <TARGET> [ADDRESS]"
    },
    {
     "abstract": "Remove capacity added with `cua ci add`: ends the computers Cua started there (only the ones it recorded and tagged), then forgets the target",
     "after_help": "Examples:\n  cua ci remove host [email protected]",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "`aws`, `gcp`, `azure`, `hetzner`, `modal`, `macstadium` or `host`",
       "hidden": false,
       "is_optional": false,
       "name": "TARGET",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "For `host`: its SSH address",
       "hidden": false,
       "is_optional": true,
       "name": "ADDRESS",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not ask",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": "y",
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "remove",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua ci remove [OPTIONS] <TARGET> [ADDRESS]"
    },
    {
     "abstract": "What Cua CI is doing: computers and free slots, waiting and running jobs, the last 7 days, and this month's spend against the budget. Pools of your own GitHub App show with `--pool`",
     "after_help": "Examples:\n  cua ci status\n  cua ci status --json\n  cua ci status --pool trycua",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "status",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A pool made with `connect --own-app` (default: Cua CI, else every pool)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "pool",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "POOL"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua ci status [OPTIONS]"
    },
    {
     "abstract": "Everything the CI Runners page shows, as JSON: setup steps, the repositories that ran jobs, usage over the last 7 days, the jobs table (wait, run, cost, computer, cloud), the autopilot's reasons and the budget. Read from this computer's own records, no network (`--live` adds the repositories the service lists)",
     "after_help": "Examples:\n  cua ci overview\n  cua ci overview --live",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Also ask the service which repositories the GitHub app can see and which of them may run jobs (needs the network)",
       "hidden": false,
       "name": "live",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "overview",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua ci overview [OPTIONS]"
    },
    {
     "abstract": "What the Cua Spaces apps run for the CI Runners page: one operation (`overview`, `connect`, `connect_token`, `connect_cancel`, `repositories`, `goal`, `log`), its arguments as one JSON object on stdin, one JSON line on stdout. Not for typing: use the commands above",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The operation",
       "hidden": false,
       "is_optional": false,
       "name": "OP",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": true,
     "hidden_aliases": [],
     "name": "app",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua ci app [OPTIONS] <OP>"
    },
    {
     "abstract": "Why capacity looks the way it does: what Cua chose from your job history (computers kept ready, idle time, spot or on-demand) and the reason for each, in plain words",
     "after_help": "Examples:\n  cua ci why\n  cua ci why aws",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "A target (`aws`, `hetzner`, ...); default: every target",
       "hidden": false,
       "is_optional": true,
       "name": "TARGET",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "why",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua ci why [OPTIONS] [TARGET]"
    },
    {
     "abstract": "Which repositories Cua CI serves, how fork pull requests are treated, concurrency caps and the monthly budget. With no options it shows the current settings",
     "after_help": "Examples:\n  cua ci config\n  cua ci config --allow acme/api\n  cua ci config --fork-prs deny\n  cua ci config --max-jobs 4 --max-macos-jobs 2 --max-job-minutes 90\n  cua ci config --budget 50 --on-budget-limit stop\n  cua ci config --repo acme/app --fork-prs restricted --max-jobs 2",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Accept `owner/*` in --allow (every repository of an owner)",
       "hidden": false,
       "name": "allow-org-wide",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Confirm the changes that widen what jobs may do",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": "y",
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "config",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Serve jobs of this repository (`owner/name`, repeatable)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "allow",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REPO"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Stop serving this repository (repeatable)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "remove",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REPO"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Fork pull requests: `restricted` (default: no secrets, read-only caches, no private network), `deny` (never served) or `allow`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "fork-prs",
       "possible_values": [
        "restricted",
        "deny",
        "allow"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "restricted | deny | allow",
       "value_name": "FORK_PRS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Apply --fork-prs and --max-jobs to this repository only",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "repo",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REPO"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Jobs at once (a number, or `none`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-jobs",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "N"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "macOS jobs at once (a number, or `none`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-macos-jobs",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "N"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The longest a job may run, in minutes (a number, or `none`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "max-job-minutes",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MINUTES"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The longest a job waits for capacity (`15m`, or `none`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "queue-timeout",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "DURATION"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Monthly budget in dollars for cloud computers (`50`, or `none`). With none set, cloud computers are not used",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "budget",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "DOLLARS"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "At the budget limit: `stop` (default) sends no more jobs to cloud computers; `warn` only warns",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "on-budget-limit",
       "possible_values": [
        "stop",
        "warn"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "stop | warn",
       "value_name": "ON_BUDGET_LIMIT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "What the budget counts: `byoc` (cloud computers, default) or `all`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "budget-scope",
       "possible_values": [
        "byoc",
        "all"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "byoc | all",
       "value_name": "BUDGET_SCOPE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Network for jobs: `deny-private` (default) keeps them off your private network and tailnet; `off`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "egress",
       "possible_values": [
        "deny-private",
        "off"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "deny-private | off",
       "value_name": "EGRESS"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua ci config [OPTIONS]"
    },
    {
     "abstract": "Stop serving jobs on this computer and remove it from Cua CI. The GitHub app stays installed unless you ask. For a pool of your own GitHub App, `--pool` removes it (its Spaces, runners and key)",
     "after_help": "Examples:\n  cua ci disconnect\n  cua ci disconnect --repo acme/old\n  cua ci disconnect --all-machines --unlink\n  cua ci disconnect --pool trycua --yes",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Remove every computer of the account, not just this one",
       "hidden": false,
       "name": "all-machines",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Also unlink the GitHub installation (removes Cua's runner group and runners)",
       "hidden": false,
       "name": "unlink",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Also uninstall the Cua CI app from GitHub",
       "hidden": false,
       "name": "uninstall",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not ask",
       "hidden": false,
       "name": "yes",
       "repeatable": false,
       "short_name": "y",
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "disconnect",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Stop serving this repository only (repeatable)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "repo",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REPO"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A pool made with `connect --own-app`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "pool",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "POOL"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua ci disconnect [OPTIONS]"
    },
    {
     "abstract": "Run what this computer serves in the foreground (what the service runs): Cua CI jobs, or a pool of your own GitHub App with `--pool`",
     "after_help": "Examples:\n  cua ci serve\n  cua ci serve --pool trycua\n  # One pass of an own-app pool, then exit\n  cua ci serve --pool trycua --once",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "One reconcile pass of an own-app pool (create, check and clean up), then exit",
       "hidden": false,
       "name": "once",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "serve",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A pool made with `connect --own-app` (default: Cua CI)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "pool",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "POOL"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua ci serve [OPTIONS]"
    },
    {
     "abstract": "An own-app pool's runners now: Space, runner, state and age",
     "after_help": "Examples:\n  cua ci ls\n  cua ci ls --pool trycua --json",
     "aliases": [
      "list"
     ],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "ls",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The pool (default: every pool)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "pool",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "POOL"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua ci ls [OPTIONS]"
    },
    {
     "abstract": "Recent jobs; or one job's timeline and Cua CI log (the job's own step logs stay at GitHub). An own-app pool's events with `--pool`",
     "after_help": "Examples:\n  cua ci logs\n  cua ci logs --repo acme/app\n  cua ci logs 9912345678/27300000111\n  cua ci logs job_01HZX --follow\n  cua ci logs --pool trycua --slot 3f9a12c0",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "A job: its `run/job` key or id (default: list recent jobs)",
       "hidden": false,
       "is_optional": true,
       "name": "JOB",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Keep showing new lines until the job ends",
       "hidden": false,
       "name": "follow",
       "repeatable": false,
       "short_name": "f",
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "logs",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only this repository's jobs",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "repo",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REPO"
      },
      {
       "aliases": [],
       "default_value": "30",
       "env": null,
       "help": "How many jobs to list",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "limit",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "LIMIT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A pool made with `connect --own-app`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "pool",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "POOL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A runner slot of that pool (`cua ci ls`, or the event log)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "slot",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SLOT"
      },
      {
       "aliases": [],
       "default_value": "40",
       "env": null,
       "help": "How many recent events of that pool to show",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "events",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "EVENTS"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua ci logs [OPTIONS] [JOB]"
    },
    {
     "abstract": "Stop an own-app pool's service (idle runners stay until it starts again)",
     "after_help": "Examples:\n  cua ci stop --pool trycua",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "stop",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The pool (default: the only one)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "pool",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "POOL"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua ci stop [OPTIONS]"
    },
    {
     "abstract": "Start an own-app pool's service again",
     "after_help": "Examples:\n  cua ci start --pool trycua",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "start",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The pool (default: the only one)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "pool",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "POOL"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua ci start [OPTIONS]"
    },
    {
     "abstract": "Empty the dependency caches and repository mirrors of this computer's pools, for a cold run (jobs restore nothing and the first checkout fetches in full)",
     "after_help": "Examples:\n  cua ci cache clear\n  cua ci cache clear --pool trycua",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "cache",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [
      {
       "abstract": "Delete the caches, mirrors and golden saved starts",
       "after_help": "Examples:\n  cua ci cache clear\n  cua ci cache clear --pool trycua",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "clear",
       "options": [
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "Only this pool (default: every pool of this computer)",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "pool",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "POOL"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua ci cache clear [OPTIONS]"
      }
     ],
     "usage": "cua ci cache [OPTIONS] <COMMAND>"
    }
   ],
   "usage": "cua ci [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Your remote use this month: computers in use at once, remote hours, and your plan. Remote hours are time spent using your computers from somewhere else; using a computer from itself is free",
   "after_help": "Examples:\n  cua usage\n  cua usage --json",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "usage",
   "options": [
    {
     "aliases": [],
     "default_value": null,
     "env": null,
     "help": "Relay URL (default $CUA_RELAY_URL, else the CUA_ENV relay, https://relay.cua.ai in production)",
     "hidden": true,
     "is_optional": true,
     "multiple_values": false,
     "name": "relay",
     "possible_values": [],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "string",
     "value_name": "RELAY"
    }
   ],
   "subcommand_optional": false,
   "subcommands": [],
   "usage": "cua usage [OPTIONS]"
  },
  {
   "abstract": "The AI providers connected once for every app that can use them: list, add (a key from stdin), test, remove. What Cua Spaces shows in Settings, Connections. (`cua connect` connects your coding apps to Cua.)",
   "after_help": "Examples:\n  cua connections list\n  cua connections add deepseek\n  cua connections test\n  cua connections remove deepseek",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "connections",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "List the providers with their state (Connected, Needs reconnect, Not connected) and the apps each works with. Never prints a key",
     "after_help": "Examples:\n  cua connections list\n  cua connections list --all\n  cua --json connections list",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Also list every provider that is not connected (by default: the ones up front and the ones with something saved)",
       "hidden": false,
       "name": "all",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "list",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua connections list [OPTIONS]"
    },
    {
     "abstract": "Connect a provider. The key is read from stdin (pipe it in; a terminal is refused so it isn't echoed). Saving never waits on the provider: `cua connections test` asks it afterwards",
     "after_help": "Examples:\n  cua connections add deepseek\n  cua connections add zai --region coding-global\n  cua connections add deepinfra --model meta-llama/Meta-Llama-3.1-70B-Instruct\n  cua connections add custom --base-url http://host:1234/v1 --model qwen",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The provider id (`cua connections list --all`)",
       "hidden": false,
       "is_optional": false,
       "name": "PROVIDER",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "discussion": ".\n\nThe provider is one of the ids `cua connections list --all` prints. Pipe the key in: `pbpaste | cua connections add deepseek`. Sign-ins another app made on this machine are imported with `cua connect setup <app> --sign-in`.",
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "add",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "How: `key` (an API key from stdin; the default) or `endpoint` (a custom endpoint: its base URL, model and API style; a key is optional)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "method",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "METHOD"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The plan or region, for a provider that has them (Z.AI: global, cn, coding-global, coding-cn)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "region",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "REGION"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The model to use, for a provider with no default model or to choose another",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "model",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "MODEL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A custom endpoint's base URL",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "base-url",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "BASE_URL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A custom endpoint's API style: openai-chat (default), openai-responses or anthropic",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "wire",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "WIRE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua connections add [OPTIONS] <PROVIDER>"
    },
    {
     "abstract": "Ask each provider whether its saved key still works (a read-only request on the provider's own host, bounded in time; offline is not a failure). A key the provider refuses is listed as Needs reconnect",
     "after_help": "Examples:\n  cua connections test\n  cua connections test openrouter",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "Only this provider",
       "hidden": false,
       "is_optional": true,
       "name": "PROVIDER",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "test",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua connections test [OPTIONS] [PROVIDER]"
    },
    {
     "abstract": "Disconnect a provider: remove what is saved for it",
     "after_help": "Examples:\n  cua connections remove deepseek",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "PROVIDER",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "remove",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua connections remove [OPTIONS] <PROVIDER>"
    },
    {
     "abstract": "The GitHub sign-in used for an approved push: what is signed in and a switch per host. An experiment: see `cua experiments`",
     "after_help": "Examples:\n  cua connections github\n  cua connections github rescan\n  cua connections github use bob\n  cua connections github use --auto --host github.com\n  cua connections github off --host ghe.example.com",
     "aliases": [],
     "arguments": [],
     "discussion": ".\n\nWhen an agent asks to push a branch and open a pull request, the host does it after you say yes on the card. This shows which account will be used and never prints a token.\n\nCua tries, in order: a token saved in Settings, Connections; GH_TOKEN or GITHUB_TOKEN in the Cua daemon's environment; the GitHub CLI (`gh auth login`), read only when an approved push runs; then git's own SSH key or credential helper for a repository with an SSH remote.",
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "github",
     "options": [],
     "subcommand_optional": true,
     "subcommands": [
      {
       "abstract": "What is signed in on each host and which account will be used (the default)",
       "after_help": "Examples:\n  cua connections github status",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "status",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua connections github status [OPTIONS]"
      },
      {
       "abstract": "Look again: what gh is signed in with, and what a saved or environment token may do (its account and scopes)",
       "after_help": "Examples:\n  cua connections github rescan",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "rescan",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua connections github rescan [OPTIONS]"
      },
      {
       "abstract": "Use this gh account for pushes and pull requests on a host",
       "after_help": "Examples:\n  cua connections github use bob\n  cua connections github use --auto --host github.com",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "The gh account (see `cua connections github`); omit with --auto",
         "hidden": false,
         "is_optional": true,
         "name": "LOGIN",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [
        {
         "aliases": [],
         "default_value": false,
         "env": null,
         "help": "Go back to the account gh uses itself",
         "hidden": false,
         "name": "auto",
         "repeatable": false,
         "short_name": null,
         "takes_value": false
        }
       ],
       "hidden": false,
       "hidden_aliases": [],
       "name": "use",
       "options": [
        {
         "aliases": [],
         "default_value": "github.com",
         "env": null,
         "help": "The GitHub host",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "host",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "HOST"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua connections github use [OPTIONS] [LOGIN]"
      },
      {
       "abstract": "Turn GitHub on for a host again",
       "after_help": "Examples:\n  cua connections github on --host ghe.example.com",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "on",
       "options": [
        {
         "aliases": [],
         "default_value": "github.com",
         "env": null,
         "help": "",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "host",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "HOST"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua connections github on [OPTIONS]"
      },
      {
       "abstract": "Turn GitHub off for a host: Cua uses no sign-in there until you turn it on",
       "after_help": "Examples:\n  cua connections github off --host ghe.example.com",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "off",
       "options": [
        {
         "aliases": [],
         "default_value": "github.com",
         "env": null,
         "help": "",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "host",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "HOST"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua connections github off [OPTIONS]"
      }
     ],
     "usage": "cua connections github [OPTIONS] [COMMAND]"
    }
   ],
   "usage": "cua connections [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Move a desktop app session (tabs, profile, sign-in) into a sandbox",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "teleport",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "List the apps this computer can teleport (JSON)",
     "after_help": "Examples:\n  cua teleport providers",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "providers",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua teleport providers [OPTIONS]"
    },
    {
     "abstract": "Describe what teleporting an app would move (JSON)",
     "after_help": "Examples:\n  cua teleport manifest --app com.google.Chrome --scope tabs",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "manifest",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "App: a bundle id or app name (\"com.google.Chrome\", \"Slack\", \"claude-code\")",
       "hidden": false,
       "is_optional": false,
       "multiple_values": false,
       "name": "app",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "APP"
      },
      {
       "aliases": [],
       "default_value": "full",
       "env": null,
       "help": "`tabs` (open tabs and session state) or `full` (the whole profile)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "scope",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SCOPE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Chrome profile to capture: a name (\"Profile 1\") or a path",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "profile",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PROFILE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Display name for the app (UI only)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "display-name",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "DISPLAY_NAME"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua teleport manifest [OPTIONS] --app <APP>"
    },
    {
     "abstract": "Teleport an app session into a sandbox",
     "after_help": "Examples:\n  # Chrome's open tabs into the sandbox dev\n  cua teleport push --app com.google.Chrome --scope tabs --sandbox dev\n  # The whole Slack profile, every item\n  cua teleport push --app Slack --sandbox dev --all",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "With `--url`, read the app in this command's own process instead of the Cua daemon. Consent, the audit record and the wipe are skipped, and macOS uses this process's permissions, not Cua's. Scheduled for removal; use `--url` alone",
       "hidden": false,
       "name": "read-as-caller",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Send every item the scope offers",
       "hidden": false,
       "name": "all",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Do not launch the app in the sandbox after importing",
       "hidden": false,
       "name": "no-launch",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Print `progress <sent> <total>` lines while uploading",
       "hidden": false,
       "name": "progress",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Send over a `relay:` destination even though this Space's image predates end-to-end sealing (S1): without this, such a send refuses before reading or uploading anything. Set it only after you understand that relay.cua.ai (or a self-hosted cua-relay) could read this delivery in the clear; local and direct destinations are unaffected either way",
       "hidden": false,
       "name": "relay-plaintext-ack",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "push",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "App: a bundle id or app name (\"com.google.Chrome\", \"Slack\", \"claude-code\")",
       "hidden": false,
       "is_optional": false,
       "multiple_values": false,
       "name": "app",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "APP"
      },
      {
       "aliases": [],
       "default_value": "full",
       "env": null,
       "help": "`tabs` (open tabs and session state) or `full` (the whole profile)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "scope",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SCOPE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Chrome profile to capture: a name (\"Profile 1\") or a path",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "profile",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PROFILE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Display name for the app (UI only)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "display-name",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "DISPLAY_NAME"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Destination sandbox (name)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "sandbox",
       "possible_values": [],
       "repeatable": false,
       "short_name": "s",
       "takes_value": true,
       "type": "string",
       "value_name": "SANDBOX"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Destination cua-spacesd URL instead of a sandbox: another daemon's API, or any machine you can reach. The browser is read by the local Cua daemon with the same Keyvault consent, audit record and wipe as `--sandbox`; `--url` only names where it goes",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "url",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "URL"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": "CUA_ENV_TOKEN",
       "help": "Token for `--url`",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "token",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "TOKEN"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Send exactly this manifest item (repeatable; see `manifest`). Default: the provider's default selection, which leaves credentials-heavy or bulky items (cookies, transcripts) out unless named here",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "include",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "INCLUDE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua teleport push [OPTIONS] --app <APP>"
    },
    {
     "abstract": "Check, in plain words, that a teleport can work now: the Keyvault, permission to read the browser's files and tabs, and the profile",
     "after_help": "Examples:\n  cua teleport doctor\n  cua teleport doctor --app chrome --profile \"Profile 1\"",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "doctor",
     "options": [
      {
       "aliases": [],
       "default_value": "chrome",
       "env": null,
       "help": "Browser to check (`chrome` or `edge`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "app",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "APP"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Profile to check: a name (\"Profile 1\"). Default: the one used last",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "profile",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PROFILE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua teleport doctor [OPTIONS]"
    }
   ],
   "usage": "cua teleport [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "The Cua Keyvault the daemon hosts: status, init, unlock, lock, saved passwords and approvals. Passphrases are prompted for (or read from stdin), never arguments",
   "after_help": "Examples:\n  cua keyvault status\n  cua keyvault init --passphrase\n  cua keyvault unlock --passphrase\n  cua keyvault import-passwords --browser chrome\n  cua keyvault requests\n  cua keyvault approve <request-id>\n  cua keyvault lock",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "keyvault",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Whether the Keyvault exists and is unlocked, and which protectors (Touch ID with the OS key store, a passphrase) the daemon can use",
     "after_help": "Examples:\n  cua keyvault status\n  cua keyvault status --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "status",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua keyvault status [OPTIONS]"
    },
    {
     "abstract": "Create the Keyvault and print its recovery key once. Uses the OS key store (Touch ID confirms) unless --passphrase or --passphrase-stdin",
     "after_help": "Examples:\n  # The OS key store (the signed Cua daemon only)\n  cua keyvault init\n  # A passphrase, typed twice at a prompt\n  cua keyvault init --passphrase\n  # Scripts: the passphrase is the first line of stdin\n  cua keyvault init --passphrase-stdin",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Use a passphrase, typed at a terminal prompt with echo off",
       "hidden": false,
       "name": "passphrase",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Use a passphrase read from the first line of stdin (scripts)",
       "hidden": false,
       "name": "passphrase-stdin",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "init",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua keyvault init [OPTIONS]"
    },
    {
     "abstract": "Unlock the Keyvault with the OS key store, or with its passphrase",
     "after_help": "Examples:\n  cua keyvault unlock\n  cua keyvault unlock --passphrase",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Use a passphrase, typed at a terminal prompt with echo off",
       "hidden": false,
       "name": "passphrase",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Use a passphrase read from the first line of stdin (scripts)",
       "hidden": false,
       "name": "passphrase-stdin",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "unlock",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua keyvault unlock [OPTIONS]"
    },
    {
     "abstract": "Lock the Keyvault (unlocking needs the OS key store or the passphrase again)",
     "after_help": "Examples:\n  cua keyvault lock",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "lock",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua keyvault lock [OPTIONS]"
    },
    {
     "abstract": "Import a browser's saved passwords into the Keyvault, one item per site. They stay sealed: agents sign in with them through `request_site_login` after you approve, and never see them. The daemon asks for Touch ID or your login password",
     "after_help": "Examples:\n  cua keyvault import-passwords --browser chrome\n  cua keyvault import-passwords --browser chrome --site github.com --site example.com\n  cua keyvault import-passwords --browser chrome --profile \"Profile 1\"",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "import-passwords",
     "options": [
      {
       "aliases": [],
       "default_value": "chrome",
       "env": null,
       "help": "The browser to import from",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "browser",
       "possible_values": [
        "chrome"
       ],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "chrome",
       "value_name": "BROWSER"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The browser profile (name or path); default: the default profile",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "profile",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PROFILE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only this site (a registrable domain such as github.com). Repeatable; default: every saved site",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "site",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SITES"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua keyvault import-passwords [OPTIONS]"
    },
    {
     "abstract": "Import a signed-in session (cookies, or a single-app session like Slack's) into the Keyvault, without delivering it anywhere. A later `cua teleport push --sandbox NAME` (or the review sheet's \"Save to Keyvault\") can deliver it; it stays sealed until then. The daemon asks for Touch ID or your login password",
     "after_help": "Examples:\n  cua keyvault import-session --app chrome\n  cua keyvault import-session --app chrome --site github.com --site example.com\n  cua keyvault import-session --app firefox --profile \"Profile 1\"\n  cua keyvault import-session --app slack",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Also carry each named site's localStorage / IndexedDB origins",
       "hidden": false,
       "name": "include-storage",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Also carry each named site's saved passwords, as part of this same session item (`cua keyvault import-passwords` keeps them as their own items instead, one per site)",
       "hidden": false,
       "name": "include-passwords",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Only session cookies: drop every persistent cookie",
       "hidden": false,
       "name": "session-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      },
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Drop persistent cookies that expire more than 30 days out (long-lived refresh tokens), keeping short sessions",
       "hidden": false,
       "name": "drop-long-lived",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "import-session",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The app to import from (a teleport provider id: `chrome`, `firefox`, `slack`, ...; `cua teleport providers` lists every one on this computer)",
       "hidden": false,
       "is_optional": false,
       "multiple_values": false,
       "name": "app",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "APP"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The browser profile (name or path); default: the default profile. Ignored for a single-app provider (Slack, Discord, ...)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "profile",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "PROFILE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Only this site's cookies (a registrable domain such as github.com). Repeatable; a browser with none named imports every site's cookies. Ignored (the whole session is one item) for a single-app provider",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "site",
       "possible_values": [],
       "repeatable": true,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SITES"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua keyvault import-session [OPTIONS] --app <APP>"
    },
    {
     "abstract": "Requests waiting for your approval (site logins, teleports)",
     "after_help": "Examples:\n  cua keyvault requests\n  cua keyvault requests --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "requests",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua keyvault requests [OPTIONS]"
    },
    {
     "abstract": "Approve a waiting request (the daemon asks for Touch ID or your login password). A site login is approved for one sign-in",
     "after_help": "Examples:\n  cua keyvault approve 5f2c9a0e",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The request id (`cua keyvault requests`)",
       "hidden": false,
       "is_optional": false,
       "name": "ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "approve",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua keyvault approve [OPTIONS] <ID>"
    },
    {
     "abstract": "Decline a waiting request",
     "after_help": "Examples:\n  cua keyvault deny 5f2c9a0e",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The request id",
       "hidden": false,
       "is_optional": false,
       "name": "ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "deny",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua keyvault deny [OPTIONS] <ID>"
    }
   ],
   "usage": "cua keyvault [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Cua Volume: the versioned volume every Space and agent shares (public/, agents/<agent>/, spaces/<space>/), its grants and audit. (`cua volume` still works for one release.)",
   "after_help": "Examples:\n  cua volume ls agents/\n  cua volume cat agents/ada/memory/MEMORY.md\n  cua volume put public/rules.md ./rules.md\n  cua volume grant agent:researcher agents/writer/outputs/\n  cua volume audit",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [
    "drive"
   ],
   "name": "volume",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "List a folder (default: the root)",
     "after_help": "Examples:\n  cua volume ls\n  cua volume ls agents/ada/\n  cua volume ls --as agent:ada --space local:work",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "name": "PATH",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "ls",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "View the drive as this persistent agent does (`agent:ada` or `ada`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "as",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "AGENT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --as: the Space the agent is in (its `spaces/<space>/` folder)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "space",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SPACE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua volume ls [OPTIONS] [PATH]"
    },
    {
     "abstract": "Print a file (or one of its versions) to stdout",
     "after_help": "Examples:\n  cua volume cat agents/ada/memory/MEMORY.md\n  cua volume cat public/rules.md --version 0001790683200000-1a2b3c4d",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "PATH",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "cat",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "version",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "VERSION"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "View the drive as this persistent agent does (`agent:ada` or `ada`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "as",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "AGENT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --as: the Space the agent is in (its `spaces/<space>/` folder)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "space",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SPACE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua volume cat [OPTIONS] <PATH>"
    },
    {
     "abstract": "Write a file from a local file, or from stdin with `-`",
     "after_help": "Examples:\n  cua volume put public/rules.md ./rules.md\n  cua volume put public/rules.md -\n  cua volume put agents/ada/inbox/brief.md ./brief.md --create-only",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "PATH",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "Local file, or `-` for stdin",
       "hidden": false,
       "is_optional": false,
       "name": "SOURCE",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Write only if nothing is at the path yet",
       "hidden": false,
       "name": "create-only",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "put",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Write only if the current version has this etag",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "if-etag",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "IF_ETAG"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "View the drive as this persistent agent does (`agent:ada` or `ada`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "as",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "AGENT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --as: the Space the agent is in (its `spaces/<space>/` folder)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "space",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SPACE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua volume put [OPTIONS] <PATH> <SOURCE>"
    },
    {
     "abstract": "Delete a file (its history stays)",
     "after_help": "Examples:\n  cua volume rm spaces/local-work/scratch.txt",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "PATH",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "rm",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "if-etag",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "IF_ETAG"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "View the drive as this persistent agent does (`agent:ada` or `ada`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "as",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "AGENT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --as: the Space the agent is in (its `spaces/<space>/` folder)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "space",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SPACE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua volume rm [OPTIONS] <PATH>"
    },
    {
     "abstract": "A file's versions, newest first",
     "after_help": "Examples:\n  cua volume history agents/ada/memory/MEMORY.md",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "PATH",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "history",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "View the drive as this persistent agent does (`agent:ada` or `ada`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "as",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "AGENT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --as: the Space the agent is in (its `spaces/<space>/` folder)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "space",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SPACE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua volume history [OPTIONS] <PATH>"
    },
    {
     "abstract": "Make an old version current again (a new version)",
     "after_help": "Examples:\n  cua volume restore agents/ada/memory/MEMORY.md 0001790683200000-1a2b3c4d",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "PATH",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "VERSION",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "restore",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "View the drive as this persistent agent does (`agent:ada` or `ada`)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "as",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "AGENT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "With --as: the Space the agent is in (its `spaces/<space>/` folder)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "space",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "SPACE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua volume restore [OPTIONS] <PATH> <VERSION>"
    },
    {
     "abstract": "Let an agent or a Space read (or, with --rw, write) a folder beyond its defaults. Asks for Touch ID or your passphrase",
     "after_help": "Examples:\n  cua volume grant agent:researcher agents/writer/outputs/\n  cua volume grant space:local-build public/datasets/ --rw --for 2h",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "`agent:<name>` or `space:<id>`",
       "hidden": false,
       "is_optional": false,
       "name": "PRINCIPAL",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      },
      {
       "default_value": null,
       "help": "A folder (ending in /) or one file",
       "hidden": false,
       "is_optional": false,
       "name": "PREFIX",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "Read and write (default: read only)",
       "hidden": false,
       "name": "rw",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "grant",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Lifetime (`30m`, `2h`, `7d`). Default: until revoked",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "for",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "DURATION"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "A note shown next to the grant",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "note",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "NOTE"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua volume grant [OPTIONS] <PRINCIPAL> <PREFIX>"
    },
    {
     "abstract": "Revoke a grant",
     "after_help": "Examples:\n  cua volume revoke 5f2c9a0b1d3e4f67",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "GRANT_ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "revoke",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua volume revoke [OPTIONS] <GRANT_ID>"
    },
    {
     "abstract": "The grants (live ones; --all includes expired and revoked)",
     "after_help": "Examples:\n  cua volume grants",
     "aliases": [],
     "arguments": [],
     "flags": [
      {
       "aliases": [],
       "default_value": false,
       "env": null,
       "help": "",
       "hidden": false,
       "name": "all",
       "repeatable": false,
       "short_name": null,
       "takes_value": false
      }
     ],
     "hidden": false,
     "hidden_aliases": [],
     "name": "grants",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua volume grants [OPTIONS]"
    },
    {
     "abstract": "Access requests agents filed, waiting for you",
     "after_help": "Examples:\n  cua volume requests",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "requests",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua volume requests [OPTIONS]"
    },
    {
     "abstract": "Turn a request into a grant. Asks for Touch ID or your passphrase",
     "after_help": "Examples:\n  cua volume approve 5f2c9a0b1d3e4f67\n  cua volume approve 5f2c9a0b1d3e4f67 --for 1d",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "REQUEST_ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "approve",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "for",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "DURATION"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua volume approve [OPTIONS] <REQUEST_ID>"
    },
    {
     "abstract": "Decline a request",
     "after_help": "Examples:\n  cua volume deny 5f2c9a0b1d3e4f67",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "",
       "hidden": false,
       "is_optional": false,
       "name": "REQUEST_ID",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "deny",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua volume deny [OPTIONS] <REQUEST_ID>"
    },
    {
     "abstract": "The audit log, newest first, and whether its hash chain verified",
     "after_help": "Examples:\n  cua volume audit\n  cua volume audit --limit 200 --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "audit",
     "options": [
      {
       "aliases": [],
       "default_value": "50",
       "env": null,
       "help": "",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "limit",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "LIMIT"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua volume audit [OPTIONS]"
    },
    {
     "abstract": "Show the drive as a volume (Finder on macOS, FUSE on Linux). Off until turned on; stays on across restarts",
     "after_help": "Examples:\n  cua volume mount\n  cua volume mount --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "mount",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua volume mount [OPTIONS]"
    },
    {
     "abstract": "Turn the volume off (files still uploading land first)",
     "after_help": "Examples:\n  cua volume unmount",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "unmount",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua volume unmount [OPTIONS]"
    },
    {
     "abstract": "The volume, sync across devices, and the block cache",
     "after_help": "Examples:\n  cua volume status\n  cua volume status --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "status",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua volume status [OPTIONS]"
    },
    {
     "abstract": "Which store the drive uses (fs, s3)",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "config",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [
      {
       "abstract": "The backend and bucket settings in effect (never keys)",
       "after_help": "Examples:\n  cua volume config show",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "show",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua volume config show [OPTIONS]"
      },
      {
       "abstract": "Choose the backend. Keys are never arguments: see set-keys",
       "after_help": "Examples:\n  cua volume config set --backend fs\n  cua volume config set --backend s3 --endpoint http://127.0.0.1:9000 --bucket cua-volume --path-style",
       "aliases": [],
       "arguments": [],
       "flags": [
        {
         "aliases": [],
         "default_value": false,
         "env": null,
         "help": "",
         "hidden": false,
         "name": "path-style",
         "repeatable": false,
         "short_name": null,
         "takes_value": false
        }
       ],
       "hidden": false,
       "hidden_aliases": [],
       "name": "set",
       "options": [
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "`fs` (default) or `s3`",
         "hidden": false,
         "is_optional": false,
         "multiple_values": false,
         "name": "backend",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "BACKEND"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "endpoint",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "ENDPOINT"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "region",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "REGION"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "bucket",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "BUCKET"
        },
        {
         "aliases": [],
         "default_value": null,
         "env": null,
         "help": "A key prefix every drive key lives under",
         "hidden": false,
         "is_optional": true,
         "multiple_values": false,
         "name": "root",
         "possible_values": [],
         "repeatable": false,
         "short_name": null,
         "takes_value": true,
         "type": "string",
         "value_name": "ROOT"
        }
       ],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua volume config set [OPTIONS] --backend <BACKEND>"
      },
      {
       "abstract": "Save S3 keys in the credential store: the access key id and the secret, one per line on stdin",
       "after_help": "Examples:\n  cua volume config set-keys",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "set-keys",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua volume config set-keys [OPTIONS]"
      }
     ],
     "usage": "cua volume config [OPTIONS] <COMMAND>"
    },
    {
     "abstract": "Named volumes: folders of the volume that Spaces mount (`cua spaces create --volume`)",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "named",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [
      {
       "abstract": "The named volumes, and the Spaces that mount each",
       "after_help": "Examples:\n  cua volume named ls\n  cua volume named ls --json",
       "aliases": [],
       "arguments": [],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "ls",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua volume named ls [OPTIONS]"
      },
      {
       "abstract": "Make an empty named volume",
       "after_help": "Examples:\n  cua volume named create shared\n  cua spaces create --volume shared:/mnt/shared",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "1 to 63 of a-z, 0-9, `.`, `_`, `-`",
         "hidden": false,
         "is_optional": false,
         "name": "NAME",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [],
       "hidden": false,
       "hidden_aliases": [],
       "name": "create",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua volume named create [OPTIONS] <NAME>"
      },
      {
       "abstract": "Delete a named volume and its files (their history stays). Refused while Spaces mount it unless --force",
       "after_help": "Examples:\n  cua volume named rm shared\n  cua volume named rm shared --force",
       "aliases": [],
       "arguments": [
        {
         "default_value": null,
         "help": "",
         "hidden": false,
         "is_optional": false,
         "name": "NAME",
         "possible_values": [],
         "repeatable": false,
         "type": "string"
        }
       ],
       "flags": [
        {
         "aliases": [],
         "default_value": false,
         "env": null,
         "help": "Delete although Spaces mount it",
         "hidden": false,
         "name": "force",
         "repeatable": false,
         "short_name": null,
         "takes_value": false
        }
       ],
       "hidden": false,
       "hidden_aliases": [],
       "name": "rm",
       "options": [],
       "subcommand_optional": false,
       "subcommands": [],
       "usage": "cua volume named rm [OPTIONS] <NAME>"
      }
     ],
     "usage": "cua volume named [OPTIONS] <COMMAND>"
    }
   ],
   "usage": "cua volume [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Anonymous usage telemetry (status, on, off, show-last, reset-id, schema). What is sent: https://cua.ai/docs/cua-sdk/concepts/telemetry",
   "after_help": "Examples:\n  cua telemetry status\n  cua telemetry off\n  cua telemetry show-last",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "telemetry",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Whether telemetry is on, why, and the exact properties every event carries",
     "after_help": "Examples:\n  cua telemetry status\n  cua telemetry status --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "status",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua telemetry status [OPTIONS]"
    },
    {
     "abstract": "Turn usage telemetry on (writes [telemetry] enabled = \\\"on\\\" to ~/.cua/config.toml)",
     "after_help": "Examples:\n  cua telemetry on",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "on",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua telemetry on [OPTIONS]"
    },
    {
     "abstract": "Turn usage telemetry off (same as `cua config set telemetry off`)",
     "after_help": "Examples:\n  cua telemetry off",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "off",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua telemetry off [OPTIONS]"
    },
    {
     "abstract": "Print the last events this computer queued or sent, exactly as sent",
     "after_help": "Examples:\n  cua telemetry show-last\n  cua telemetry show-last -n 5 --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "show-last",
     "options": [
      {
       "aliases": [],
       "default_value": "20",
       "env": null,
       "help": "How many",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "limit",
       "possible_values": [],
       "repeatable": false,
       "short_name": "n",
       "takes_value": true,
       "type": "integer",
       "value_name": "LIMIT"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua telemetry show-last [OPTIONS]"
    },
    {
     "abstract": "Delete the anonymous install id and salt (new ones are created on the next event)",
     "after_help": "Examples:\n  cua telemetry reset-id",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "reset-id",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua telemetry reset-id [OPTIONS]"
    },
    {
     "abstract": "Every event and property that may be sent, with its allowed values",
     "after_help": "Examples:\n  cua telemetry schema --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "schema",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua telemetry schema [OPTIONS]"
    }
   ],
   "usage": "cua telemetry [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "Spaces performance benchmarks: list them, run one in Spaces of its own (writes result.json and samples.csv in the bench-result v1 format), and check a run against a committed baseline",
   "after_help": "Examples:\n  cua bench list\n  cua bench run microvm-fork --n 5 --out ./mf\n  cua bench check ./mf/result.json --baseline microvm-fork/baseline.json",
   "aliases": [],
   "arguments": [],
   "flags": [],
   "hidden": false,
   "hidden_aliases": [],
   "name": "bench",
   "options": [],
   "subcommand_optional": false,
   "subcommands": [
    {
     "abstract": "Every benchmark: what it measures, the host it needs, what `--n` sets and whether it has a perf guard",
     "after_help": "Examples:\n  cua bench list\n  cua bench list --json",
     "aliases": [],
     "arguments": [],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "list",
     "options": [],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua bench list [OPTIONS]"
    },
    {
     "abstract": "Run one benchmark in Spaces of its own and write the run as bench-result v1: result.json, samples.csv and the bench's own output in raw/",
     "after_help": "Every run uses a Spaces home of its own (<out>/cua-home, or CUA_HOME when\nset) and a daemon of this binary, and deletes the Spaces it creates. A bench\nthat needs a program a release does not ship (CHANNEL_BENCH, ROLLOUT_BENCH,\nDISK, a source checkout) stops and says how to get it (`cua bench list`).\n\nExamples:\n  # 5 samples per measurement, results in ./mf\n  cua bench run microvm-fork --n 5 --out ./mf\n  # With CHANNEL_BENCH set to the SDK's channel_bench example\n  cua bench run channel\n  # The run as JSON on stdout (progress stays on stderr)\n  cua bench run microvm-fork --json",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "The benchmark (`cua bench list`)",
       "hidden": false,
       "is_optional": false,
       "name": "NAME",
       "possible_values": [],
       "repeatable": false,
       "type": "string"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "run",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Directory for result.json, samples.csv and raw/ (default ./bench-results/<name>/<UTC time>)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "out",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "path",
       "value_name": "OUT"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Samples (or the size the bench scales by; `cua bench list` says which). Default: the bench's own",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "n",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "integer",
       "value_name": "N"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Source checkout (libs/cua) for benches that build with cargo (default: CUA_SRC, or the checkout the current directory is in)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "src",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "path",
       "value_name": "SRC"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua bench run [OPTIONS] <NAME>"
    },
    {
     "abstract": "Apply a benchmark's perf guard to a run against a committed baseline; exits 1 on a regression",
     "after_help": "A baseline path that does not exist as given is looked up among the\nbaselines this binary ships (relative to the bench directory).\n\nExamples:\n  cua bench check ./mf/result.json --baseline microvm-fork/baseline.json\n  cua bench check ./ff/result.json --baseline fork-fanout/baseline.json --host macos-hvf",
     "aliases": [],
     "arguments": [
      {
       "default_value": null,
       "help": "A result.json `cua bench run` wrote (its raw/ directory next to it)",
       "hidden": false,
       "is_optional": false,
       "name": "RESULT",
       "possible_values": [],
       "repeatable": false,
       "type": "path"
      }
     ],
     "flags": [],
     "hidden": false,
     "hidden_aliases": [],
     "name": "check",
     "options": [
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "The baseline file",
       "hidden": false,
       "is_optional": false,
       "multiple_values": false,
       "name": "baseline",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "path",
       "value_name": "BASELINE"
      },
      {
       "aliases": [],
       "default_value": null,
       "env": null,
       "help": "Host class or profile in a baseline that holds several (fork-fanout, fork-batch)",
       "hidden": false,
       "is_optional": true,
       "multiple_values": false,
       "name": "host",
       "possible_values": [],
       "repeatable": false,
       "short_name": null,
       "takes_value": true,
       "type": "string",
       "value_name": "HOST"
      }
     ],
     "subcommand_optional": false,
     "subcommands": [],
     "usage": "cua bench check [OPTIONS] --baseline <BASELINE> <RESULT>"
    }
   ],
   "usage": "cua bench [OPTIONS] <COMMAND>"
  },
  {
   "abstract": "(internal) The CLI and MCP surface as JSON, for the generated docs",
   "aliases": [],
   "arguments": [],
   "flags": [
    {
     "aliases": [],
     "default_value": false,
     "env": null,
     "help": "Pretty-print",
     "hidden": false,
     "name": "pretty",
     "repeatable": false,
     "short_name": null,
     "takes_value": false
    }
   ],
   "hidden": true,
   "hidden_aliases": [],
   "name": "dump-docs",
   "options": [
    {
     "aliases": [],
     "default_value": "all",
     "env": null,
     "help": "What to dump",
     "hidden": false,
     "is_optional": true,
     "multiple_values": false,
     "name": "type",
     "possible_values": [
      "cli",
      "mcp",
      "all"
     ],
     "repeatable": false,
     "short_name": null,
     "takes_value": true,
     "type": "cli | mcp | all",
     "value_name": "KIND"
    }
   ],
   "subcommand_optional": false,
   "subcommands": [],
   "usage": "cua dump-docs [OPTIONS]"
  }
 ],
 "deprecated_commands": [
  {
   "deprecated": true,
   "name": "cua agents",
   "replaced_by": "cua connect"
  },
  {
   "deprecated": true,
   "name": "cua agent create",
   "replaced_by": "cua agent add"
  },
  {
   "deprecated": true,
   "name": "cua agent persistent",
   "replaced_by": "cua agent ls"
  },
  {
   "deprecated": true,
   "name": "cua agent tell",
   "replaced_by": "cua agent send"
  },
  {
   "deprecated": true,
   "name": "cua agent forget",
   "replaced_by": "cua agent rm"
  },
  {
   "deprecated": true,
   "name": "cua agent routine",
   "replaced_by": "cua agent schedule"
  }
 ],
 "exit_codes": [
  {
   "code": 0,
   "meaning": "Success"
  },
  {
   "code": 1,
   "meaning": "Failure, or `cua do` reported an error"
  },
  {
   "code": 2,
   "meaning": "Invalid argument, or an ambiguous sandbox name (qualify it: `local:NAME`)"
  },
  {
   "code": 3,
   "meaning": "Not found: sandbox, window, skill or image (or an image not published yet)"
  },
  {
   "code": 4,
   "meaning": "Not supported, or not configured (for example no provider credentials)"
  },
  {
   "code": 5,
   "meaning": "No cua-spacesd answered, or a transport failure"
  },
  {
   "code": 6,
   "meaning": "Unauthenticated or permission denied (by Cua or your cloud account)"
  },
  {
   "code": 7,
   "meaning": "Not enough free disk space (see `cua cache`)"
  },
  {
   "code": 8,
   "meaning": "No room on the machine: its VMs are at their memory or CPU limit, or it is low on memory"
  },
  {
   "code": 130,
   "meaning": "Cancelled (Ctrl-C during a create): what it made was removed"
  }
 ],
 "global_options": [
  {
   "aliases": [],
   "default_value": false,
   "env": null,
   "help": "Use an embedded runtime even when a daemon runs",
   "hidden": false,
   "name": "embedded",
   "repeatable": false,
   "short_name": null,
   "takes_value": false
  },
  {
   "aliases": [],
   "default_value": null,
   "env": "CUA_DAEMON",
   "help": "Daemon address (socket path or loopback URL)",
   "hidden": false,
   "is_optional": true,
   "multiple_values": false,
   "name": "daemon",
   "possible_values": [],
   "repeatable": false,
   "short_name": null,
   "takes_value": true,
   "type": "string",
   "value_name": "DAEMON"
  },
  {
   "aliases": [],
   "default_value": null,
   "env": "CUA_DAEMON_TOKEN",
   "help": "Daemon token (loopback URLs)",
   "hidden": false,
   "is_optional": true,
   "multiple_values": false,
   "name": "daemon-token",
   "possible_values": [],
   "repeatable": false,
   "short_name": null,
   "takes_value": true,
   "type": "string",
   "value_name": "DAEMON_TOKEN"
  },
  {
   "aliases": [],
   "default_value": null,
   "env": null,
   "help": "Sandbox state directory (embedded; default ~/.cua/sandboxes)",
   "hidden": false,
   "is_optional": true,
   "multiple_values": false,
   "name": "state-dir",
   "possible_values": [],
   "repeatable": false,
   "short_name": null,
   "takes_value": true,
   "type": "string",
   "value_name": "STATE_DIR"
  },
  {
   "aliases": [],
   "default_value": false,
   "env": null,
   "help": "Print JSON",
   "hidden": false,
   "name": "json",
   "repeatable": false,
   "short_name": null,
   "takes_value": false
  }
 ],
 "name": "cua",
 "usage": "cua [OPTIONS] <COMMAND>",
 "version": "0.12.1"
}