terminal

cmdhub adapter

cmdhub CLI
for cmdhub.

Control plane for install, auth, provider links, config, and suite health.

lock Auth: cmdhub account

Quick Install curl -fsSL https://cmdhub.run/install.sh | bash

data_object Agent Contract

Agents should start with auth/status and discovery commands, inspect schemas before composition, and treat commands marked as mutating as state-changing operations.

catalog.json Markdown

Output

Use human output for reading, `--json` for one object, and `--jsonl` for pipes.

Auth

cmdhub account session. Website account auth does not grant provider API access.

Refs

Prefer list/search, then short refs or piped JSONL. Use `resolve` to inspect cached refs.

Schemas

Use `cmdhub schema` and `catalog.json` to inspect fields, flags, examples, and side effects.

Auth scopes

cmdhub registry/account session

terminal Command Reference

Generated from source. Global flags apply to all commands.

Global Flags

--json bool Emit JSON machine output

--jsonl bool Emit JSONL records for piping

--output, -o string Compatibility output mode: json|jsonl. Prefer --json or --jsonl

--view string = summary View mode: summary|full

--profile string Config/auth profile

--config string Config path override

--quiet, -q bool Suppress non-essential diagnostics

--debug bool Enable debug diagnostics

--limit int = 50 Maximum items to emit

--page-size int = 50 Requested upstream page size

--cursor string Continuation cursor

--no-paginate bool Fetch only one page

--version, -v bool Print version information

cmdhub auth Manage cmdhub account authentication

#cmd-cmdhub-auth discovery safe

Manage the local cmdhub account session. Login opens the cmdhub web auth page and stores the resulting hub session.

$ cmdhub auth login

$ cmdhub auth status

$ cmdhub auth whoami

$ cmdhub auth logout

cmdhub auth login Start browser login for cmdhub

#cmd-cmdhub-auth-login mutates state

--email string Account email for manual bootstrap

--host string = https://cmdhub.run Cmdhub web auth host

--name string Display name for manual bootstrap

--timeout duration = 2m0s How long to wait for browser login

--token string Manual bootstrap session token

--user-id string User identifier for manual bootstrap

$ cmdhub auth login

$ cmdhub auth login --help

$ cmdhub auth login --token <token> --email you@example.com

cmdhub auth logout Clear cmdhub auth state

#cmd-cmdhub-auth-logout mutates state

$ cmdhub auth logout

$ cmdhub auth logout --help

cmdhub auth status Show cmdhub auth status

#cmd-cmdhub-auth-status discovery safe

$ cmdhub auth status

$ cmdhub auth status --view full

cmdhub auth whoami Show the current cmdhub account

#cmd-cmdhub-auth-whoami discovery safe

$ cmdhub auth whoami

cmdhub capabilities Show tool capabilities

#cmd-cmdhub-capabilities discovery safe

$ cmdhub capabilities

$ cmdhub capabilities --json

$ cmdhub capabilities gmail

$ cmdhub capabilities gmail --json

cmdhub config Manage shared cmdhub config

#cmd-cmdhub-config discovery safe

$ cmdhub config get

$ cmdhub config get credential_backend

$ cmdhub config set credential_backend auto

cmdhub config get Get config values

#cmd-cmdhub-config-get discovery safe

$ cmdhub config get

$ cmdhub config get credential_backend

$ cmdhub config get credential_backend --json

cmdhub config set Set a config value

#cmd-cmdhub-config-set mutates state

$ cmdhub config set --help

$ cmdhub config set credential_backend auto

$ cmdhub config set docs_open_command xdg-open

cmdhub doctor Run suite diagnostics

#cmd-cmdhub-doctor discovery safe

$ cmdhub doctor

$ cmdhub doctor --view full

$ cmdhub doctor gmail

cmdhub get Install one or more tools

#cmd-cmdhub-get discovery safe

$ cmdhub get --help

$ cmdhub get gmail

$ cmdhub get gmail gcal slack

$ cmdhub get gmail gcal slack notion

$ cmdhub get gmail@0.4.0

cmdhub info Show metadata for one tool

#cmd-cmdhub-info discovery safe

$ cmdhub info

$ cmdhub info gmail

$ cmdhub info gmail --json

$ cmdhub info gmail --view full

cmdhub installed List installed tools

#cmd-cmdhub-installed discovery safe

$ cmdhub installed

$ cmdhub installed --view full

cmdhub list List known tools

#cmd-cmdhub-list discovery safe

$ cmdhub list

$ cmdhub list --jsonl

$ cmdhub list --view full

cmdhub login Start browser login for cmdhub

#cmd-cmdhub-login mutates state

--email string Account email for manual bootstrap

--host string = https://cmdhub.run Cmdhub web auth host

--name string Display name for manual bootstrap

--timeout duration = 2m0s How long to wait for browser login

--token string Manual bootstrap session token

--user-id string User identifier for manual bootstrap

$ cmdhub auth login

$ cmdhub login

$ cmdhub login --token <token> --email you@example.com

cmdhub logout Clear cmdhub auth state

#cmd-cmdhub-logout mutates state

$ cmdhub auth logout

$ cmdhub logout

cmdhub pin Pin an installed tool to a version

#cmd-cmdhub-pin mutates state

$ cmdhub pin --help

$ cmdhub pin gmail

$ cmdhub pin gmail@0.4.0

cmdhub remove Remove installed tools

#cmd-cmdhub-remove mutates state

$ cmdhub remove --help

$ cmdhub remove gmail

$ cmdhub remove gmail gcal

cmdhub schema Show a tool command schema when supported

#cmd-cmdhub-schema discovery safe

--in bool Show input schema

--out bool Show output schema

$ cmdhub schema

$ cmdhub schema cmdhub tool.list --out

$ cmdhub schema gmail message.create --in

$ cmdhub schema gmail message.get --out

cmdhub telemetry Manage anonymous cmdhub telemetry

#cmd-cmdhub-telemetry discovery safe

$ cmdhub telemetry status

$ cmdhub telemetry disable

$ cmdhub telemetry flush

cmdhub telemetry disable Disable anonymous telemetry

#cmd-cmdhub-telemetry-disable discovery safe

$ cmdhub telemetry disable

$ cmdhub telemetry disable --help

cmdhub telemetry enable Enable anonymous telemetry

#cmd-cmdhub-telemetry-enable discovery safe

$ cmdhub telemetry enable

$ cmdhub telemetry enable --help

cmdhub telemetry flush Upload queued telemetry now

#cmd-cmdhub-telemetry-flush discovery safe

$ cmdhub telemetry flush

$ cmdhub telemetry flush --help

cmdhub telemetry path Show the local telemetry queue path

#cmd-cmdhub-telemetry-path discovery safe

$ cmdhub telemetry path

cmdhub telemetry status Show telemetry status

#cmd-cmdhub-telemetry-status discovery safe

$ cmdhub telemetry status

$ cmdhub telemetry status --json

cmdhub unpin Clear a version pin on an installed tool

#cmd-cmdhub-unpin mutates state

$ cmdhub unpin --help

$ cmdhub unpin gmail

cmdhub update Update installed tools

#cmd-cmdhub-update mutates state

Preview updates for installed tools. Rerun with –yes to apply. Pinned tools are held back.

--all bool Plan updates for every installed tool (default if no targets are given)

--yes, -y bool Apply the planned updates

$ cmdhub update

$ cmdhub update --all

$ cmdhub update --help

$ cmdhub update all

$ cmdhub update gmail --yes

cmdhub version Show cmdhub version information

#cmd-cmdhub-version discovery safe

$ cmdhub version

$ cmdhub version --json

cmdhub whoami Show the current cmdhub account

#cmd-cmdhub-whoami discovery safe

$ cmdhub whoami

play_circle Live Examples

Output captured from a real workspace. Regenerate with scripts/gen-docs.sh --update.

lifecycle

Show root help Shows installed command families and global usage.

$ cmdhub --help

Manage the cmdhub suite: install tools, inspect tool metadata, and run suite diagnostics.

Cmdhub is the control plane. App CLIs such as gmail, gcal, slack, notion, and agent remain the data plane.

Usage:
  cmdhub [command]

Examples:
  cmdhub auth login
  cmdhub list
  cmdhub get gmail gcal
  gmail login
  cmdhub doctor
  cmdhub schema gmail message.get --out

Available Commands:
  auth         Manage cmdhub account authentication
  capabilities Show tool capabilities
  completion   Generate the autocompletion script for the specified shell
  config       Manage shared cmdhub config
  doctor       Run suite diagnostics
  get          Install one or more tools
  help         Help about any command
  info         Show metadata for one tool
  installed    List installed tools
  list         List known tools
  login        Start browser login for cmdhub
  logout       Clear cmdhub auth state
  pin          Pin an installed tool to a version
  remove       Remove installed tools
  schema       Show a tool command schema when supported
  telemetry    Manage anonymous cmdhub telemetry
  unpin        Clear a version pin on an installed tool
  update       Update installed tools
  version      Show cmdhub version information
  whoami       Show the current cmdhub account

Flags:
      --config string   Config path override
      --cursor string   Continuation cursor
      --debug           Enable debug diagnostics
  -h, --help            help for cmdhub
      --json            Emit JSON machine output
      --jsonl           Emit JSONL records for piping
      --limit int       Maximum items to emit (default 50)
      --no-paginate     Fetch only one page
  -o, --output string   Compatibility output mode: json|jsonl. Prefer --json or --jsonl
      --page-size int   Requested upstream page size (default 50)
  -q, --quiet           Suppress non-essential diagnostics
  -v, --version         Print version information
      --view string     View mode: summary|full (default "summary")

Use "cmdhub [command] --help" for more information about a command.

Inspect available tools Lists known tools, install state, auth mode, and machine-output support.

$ cmdhub list

TOOL         VERSION      STATUS           AUTH           SCHEMA  JSONL
cmdhub       dev          update available session        yes     yes  
gcal         0.0.3        not installed    oauth          yes     yes  
gmail        0.0.5        not installed    oauth          yes     yes  
signal       0.0.1        not installed    device_link    yes     yes  
slack        0.0.3        not installed    oauth          yes     yes  

Next steps:
- Run:       cmdhub get gcal
- Installed: cmdhub installed
- Update:    cmdhub update

Show version Prints cmdhub build metadata.

$ cmdhub version

cmdhub dev

Next steps:
- Doctor: cmdhub doctor
- List:   cmdhub list

diagnostics

Show telemetry status Shows anonymous telemetry status.

$ cmdhub telemetry status

Telemetry: disabled
Pending:   {count}

Next steps:
- Flush:  cmdhub telemetry flush
- Enable: cmdhub telemetry enable

schemas

Inspect a command schema Shows a command output schema without needing provider auth.

$ cmdhub schema cmdhub tool.list --out

Schema: cmdhub.tool.list.v1.output (cmdhub tool list output)
Required: name, latest_version, status
Optional: display_name, auth_mode, installed, installed_version, command_schema, jsonl
Fields:
  auth_mode          Authentication mode
  name               Tool command name
  status             Install/update state

alt_route Composition Patterns

Bridge your ecosystem with zero middleware.

# Install the current suite, then inspect what is available
cmdhub auth login
cmdhub get gmail gcal gdrive mscal msdrive mstodo msoutlook slack notion agent
cmdhub list

cmdhub CLIfor cmdhub.

data_object Agent Contract

Output

Auth

Refs

Schemas

Auth scopes

terminal Command Reference

Global Flags

play_circle Live Examples

lifecycle

diagnostics

schemas

alt_route Composition Patterns

cmdhub CLI
for cmdhub.