{
  "schema_version": "cmdhub.website.command_catalog.v1",
  "tool": "cmdhub",
  "title": "cmdhub CLI",
  "description": "Control plane for install, auth, provider links, config, and suite health.",
  "auth_mode": "cmdhub account",
  "auth_scopes": {
    "label": "cmdhub account session",
    "scopes": [
      "cmdhub registry/account session"
    ],
    "note": "Website account auth does not grant provider API access."
  },
  "markdown_url": "/cli/cmdhub/index.md",
  "commands": [
    {
      "id": "cmd-cmdhub-auth",
      "path": "cmdhub auth",
      "name": "auth",
      "short": "Manage cmdhub account authentication",
      "long": "Manage the local cmdhub account session. Login opens the cmdhub web auth page and stores the resulting hub session.",
      "mutates": false,
      "safe_discovery": false,
      "supports_dry_run": false,
      "example": "cmdhub auth login\n  cmdhub auth status\n  cmdhub auth whoami\n  cmdhub auth logout",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-auth-login",
      "path": "cmdhub auth login",
      "name": "login",
      "short": "Start browser login for cmdhub",
      "long": "",
      "mutates": true,
      "safe_discovery": false,
      "supports_dry_run": false,
      "example": "cmdhub auth login\ncmdhub auth login --help\ncmdhub auth login --token <token> --email you@example.com",
      "flags": [
        {
          "name": "email",
          "type": "string",
          "usage": "Account email for manual bootstrap"
        },
        {
          "name": "host",
          "type": "string",
          "default": "https://cmdhub.run",
          "usage": "Cmdhub web auth host"
        },
        {
          "name": "name",
          "type": "string",
          "usage": "Display name for manual bootstrap"
        },
        {
          "name": "timeout",
          "type": "duration",
          "default": "2m0s",
          "usage": "How long to wait for browser login"
        },
        {
          "name": "token",
          "type": "string",
          "usage": "Manual bootstrap session token"
        },
        {
          "name": "user-id",
          "type": "string",
          "usage": "User identifier for manual bootstrap"
        }
      ]
    },
    {
      "id": "cmd-cmdhub-auth-logout",
      "path": "cmdhub auth logout",
      "name": "logout",
      "short": "Clear cmdhub auth state",
      "long": "",
      "mutates": true,
      "safe_discovery": false,
      "supports_dry_run": false,
      "example": "cmdhub auth logout\ncmdhub auth logout --help",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-auth-status",
      "path": "cmdhub auth status",
      "name": "status",
      "short": "Show cmdhub auth status",
      "long": "",
      "mutates": false,
      "safe_discovery": true,
      "supports_dry_run": false,
      "example": "cmdhub auth status\ncmdhub auth status --view full",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-auth-whoami",
      "path": "cmdhub auth whoami",
      "name": "whoami",
      "short": "Show the current cmdhub account",
      "long": "",
      "mutates": false,
      "safe_discovery": true,
      "supports_dry_run": false,
      "example": "cmdhub auth whoami",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-capabilities",
      "path": "cmdhub capabilities",
      "name": "capabilities",
      "short": "Show tool capabilities",
      "long": "",
      "mutates": false,
      "safe_discovery": true,
      "supports_dry_run": false,
      "example": "cmdhub capabilities\ncmdhub capabilities --json\ncmdhub capabilities gmail\ncmdhub capabilities gmail --json",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-config",
      "path": "cmdhub config",
      "name": "config",
      "short": "Manage shared cmdhub config",
      "long": "",
      "mutates": false,
      "safe_discovery": false,
      "supports_dry_run": false,
      "example": "cmdhub config get\n  cmdhub config get credential_backend\n  cmdhub config set credential_backend auto",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-config-get",
      "path": "cmdhub config get",
      "name": "get",
      "short": "Get config values",
      "long": "",
      "mutates": false,
      "safe_discovery": true,
      "supports_dry_run": false,
      "example": "cmdhub config get\ncmdhub config get credential_backend\ncmdhub config get credential_backend --json",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-config-set",
      "path": "cmdhub config set",
      "name": "set",
      "short": "Set a config value",
      "long": "",
      "mutates": true,
      "safe_discovery": false,
      "supports_dry_run": false,
      "example": "cmdhub config set --help\ncmdhub config set credential_backend auto\ncmdhub config set docs_open_command xdg-open",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-doctor",
      "path": "cmdhub doctor",
      "name": "doctor",
      "short": "Run suite diagnostics",
      "long": "",
      "mutates": false,
      "safe_discovery": true,
      "supports_dry_run": false,
      "example": "cmdhub doctor\ncmdhub doctor --view full\ncmdhub doctor gmail",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-get",
      "path": "cmdhub get",
      "name": "get",
      "short": "Install one or more tools",
      "long": "",
      "mutates": false,
      "safe_discovery": true,
      "supports_dry_run": false,
      "example": "cmdhub get --help\ncmdhub get gmail\ncmdhub get gmail gcal slack\ncmdhub get gmail gcal slack notion\ncmdhub get gmail@0.4.0",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-info",
      "path": "cmdhub info",
      "name": "info",
      "short": "Show metadata for one tool",
      "long": "",
      "mutates": false,
      "safe_discovery": true,
      "supports_dry_run": false,
      "example": "cmdhub info\ncmdhub info gmail\ncmdhub info gmail --json\ncmdhub info gmail --view full",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-installed",
      "path": "cmdhub installed",
      "name": "installed",
      "short": "List installed tools",
      "long": "",
      "mutates": false,
      "safe_discovery": true,
      "supports_dry_run": false,
      "example": "cmdhub installed\ncmdhub installed --view full",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-list",
      "path": "cmdhub list",
      "name": "list",
      "short": "List known tools",
      "long": "",
      "mutates": false,
      "safe_discovery": true,
      "supports_dry_run": false,
      "example": "cmdhub list\ncmdhub list --jsonl\ncmdhub list --view full",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-login",
      "path": "cmdhub login",
      "name": "login",
      "short": "Start browser login for cmdhub",
      "long": "",
      "mutates": true,
      "safe_discovery": false,
      "supports_dry_run": false,
      "example": "cmdhub auth login\ncmdhub login\ncmdhub login --token <token> --email you@example.com",
      "flags": [
        {
          "name": "email",
          "type": "string",
          "usage": "Account email for manual bootstrap"
        },
        {
          "name": "host",
          "type": "string",
          "default": "https://cmdhub.run",
          "usage": "Cmdhub web auth host"
        },
        {
          "name": "name",
          "type": "string",
          "usage": "Display name for manual bootstrap"
        },
        {
          "name": "timeout",
          "type": "duration",
          "default": "2m0s",
          "usage": "How long to wait for browser login"
        },
        {
          "name": "token",
          "type": "string",
          "usage": "Manual bootstrap session token"
        },
        {
          "name": "user-id",
          "type": "string",
          "usage": "User identifier for manual bootstrap"
        }
      ]
    },
    {
      "id": "cmd-cmdhub-logout",
      "path": "cmdhub logout",
      "name": "logout",
      "short": "Clear cmdhub auth state",
      "long": "",
      "mutates": true,
      "safe_discovery": false,
      "supports_dry_run": false,
      "example": "cmdhub auth logout\ncmdhub logout",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-pin",
      "path": "cmdhub pin",
      "name": "pin",
      "short": "Pin an installed tool to a version",
      "long": "",
      "mutates": true,
      "safe_discovery": false,
      "supports_dry_run": false,
      "example": "cmdhub pin --help\ncmdhub pin gmail\ncmdhub pin gmail@0.4.0",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-remove",
      "path": "cmdhub remove",
      "name": "remove",
      "short": "Remove installed tools",
      "long": "",
      "mutates": true,
      "safe_discovery": false,
      "supports_dry_run": false,
      "example": "cmdhub remove --help\ncmdhub remove gmail\ncmdhub remove gmail gcal",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-schema",
      "path": "cmdhub schema",
      "name": "schema",
      "short": "Show a tool command schema when supported",
      "long": "",
      "mutates": false,
      "safe_discovery": true,
      "supports_dry_run": false,
      "example": "cmdhub schema\ncmdhub schema cmdhub tool.list --out\ncmdhub schema gmail message.create --in\ncmdhub schema gmail message.get --out",
      "flags": [
        {
          "name": "in",
          "type": "bool",
          "usage": "Show input schema"
        },
        {
          "name": "out",
          "type": "bool",
          "usage": "Show output schema"
        }
      ]
    },
    {
      "id": "cmd-cmdhub-telemetry",
      "path": "cmdhub telemetry",
      "name": "telemetry",
      "short": "Manage anonymous cmdhub telemetry",
      "long": "",
      "mutates": false,
      "safe_discovery": false,
      "supports_dry_run": false,
      "example": "cmdhub telemetry status\n  cmdhub telemetry disable\n  cmdhub telemetry flush",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-telemetry-disable",
      "path": "cmdhub telemetry disable",
      "name": "disable",
      "short": "Disable anonymous telemetry",
      "long": "",
      "mutates": false,
      "safe_discovery": false,
      "supports_dry_run": false,
      "example": "cmdhub telemetry disable\ncmdhub telemetry disable --help",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-telemetry-enable",
      "path": "cmdhub telemetry enable",
      "name": "enable",
      "short": "Enable anonymous telemetry",
      "long": "",
      "mutates": false,
      "safe_discovery": false,
      "supports_dry_run": false,
      "example": "cmdhub telemetry enable\ncmdhub telemetry enable --help",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-telemetry-flush",
      "path": "cmdhub telemetry flush",
      "name": "flush",
      "short": "Upload queued telemetry now",
      "long": "",
      "mutates": false,
      "safe_discovery": false,
      "supports_dry_run": false,
      "example": "cmdhub telemetry flush\ncmdhub telemetry flush --help",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-telemetry-path",
      "path": "cmdhub telemetry path",
      "name": "path",
      "short": "Show the local telemetry queue path",
      "long": "",
      "mutates": false,
      "safe_discovery": true,
      "supports_dry_run": false,
      "example": "cmdhub telemetry path",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-telemetry-status",
      "path": "cmdhub telemetry status",
      "name": "status",
      "short": "Show telemetry status",
      "long": "",
      "mutates": false,
      "safe_discovery": true,
      "supports_dry_run": false,
      "example": "cmdhub telemetry status\ncmdhub telemetry status --json",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-unpin",
      "path": "cmdhub unpin",
      "name": "unpin",
      "short": "Clear a version pin on an installed tool",
      "long": "",
      "mutates": true,
      "safe_discovery": false,
      "supports_dry_run": false,
      "example": "cmdhub unpin --help\ncmdhub unpin gmail",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-update",
      "path": "cmdhub update",
      "name": "update",
      "short": "Update installed tools",
      "long": "Preview updates for installed tools. Rerun with --yes to apply. Pinned tools are held back.",
      "mutates": true,
      "safe_discovery": false,
      "supports_dry_run": false,
      "example": "cmdhub update\ncmdhub update --all\ncmdhub update --help\ncmdhub update all\ncmdhub update gmail --yes",
      "flags": [
        {
          "name": "all",
          "type": "bool",
          "usage": "Plan updates for every installed tool (default if no targets are given)"
        },
        {
          "name": "yes",
          "shorthand": "y",
          "type": "bool",
          "usage": "Apply the planned updates"
        }
      ]
    },
    {
      "id": "cmd-cmdhub-version",
      "path": "cmdhub version",
      "name": "version",
      "short": "Show cmdhub version information",
      "long": "",
      "mutates": false,
      "safe_discovery": true,
      "supports_dry_run": false,
      "example": "cmdhub version\ncmdhub version --json",
      "flags": []
    },
    {
      "id": "cmd-cmdhub-whoami",
      "path": "cmdhub whoami",
      "name": "whoami",
      "short": "Show the current cmdhub account",
      "long": "",
      "mutates": false,
      "safe_discovery": true,
      "supports_dry_run": false,
      "example": "cmdhub whoami",
      "flags": []
    }
  ]
}