cchp

The command-line tool for CCHP (Claude Code Hub Plus). People get a home screen with a usage heatmap, wallet and package details, providers, keys, LLM tokens and recent requests. Agents and scripts get every control-plane operation behind one predictable JSON contract.

Install

With Homebrew (macOS or Linux):

brew install cch-hq/tap/cchp

Or with the install script:

curl -fsSL https://raw.githubusercontent.com/CCH-HQ/cchp-cli/main/install.sh | sh

Or with Go: go install github.com/CCH-HQ/cchp-cli/cmd/cchp@latest. Details and other options: docs/install.md.

Start in 30 seconds: people

1. In the CCHP console, open Account › Security › Management tokens and create a token.
2. Run cchp login, enter your server address and paste the token.
3. Run cchp and pick a task.

Start in 30 seconds: agents

export CCHP_BASE_URL=https://hub.example.com
export CCHP_TOKEN_FILE=~/.config/cchp/token        # a file only you can read
cchp commands --search "usage summary" --json       # find the operation
cchp schema getUsageSummary --json                  # its inputs and output
cchp api getUsageSummary --json                     # one JSON result on stdout
cchp skill install --project                        # teach Claude Code the loop

Agent mode reads only; changes need --allow-write, and deletions or one-time secrets also need --confirm <operationId>.

Documentation

• Install
• Guide for people
• Guide for agents
• Output contract
• Safety model
• Coverage: every CCHP operation and whether cchp runs it
• Updating the spec
• How cchp is built
• Changelog
• Release distribution

In the terminal: cchp guide lists short guides, and every command has --help.

License

MIT