General
Core commands
The ccpp commands that exist whatever plugins you use: doctor, about, account, update and marketplace.
Every command prints Markdown, or JSON with the global --json option. ccpp alone prints the help.
ccpp doctor
Checks the environment ccpp depends on and exits 1 when a check fails.
| Check | Fails or warns when |
|---|---|
claude, git | the program is missing or failing (fail) |
pnpm | missing (warn) |
| ccpp home | ~/.ccpp (or $CCPP_HOME) does not exist (fail) |
| ccpp config | ~/.ccpp/config.yml is invalid |
user / project .claude | ~/.claude or the project's .claude/ is missing (warn) |
| ccpp source | the source checkout used by ccpp update is missing (warn) |
Plugins add their own checks. CPO fails on invalid policy files and warns about profile files edited since they were set.
ccpp about
Version, build (commit, date, compiled or not) and the plugins compiled into this binary.
ccpp account
Your ccpp.dev account. Credentials live in ~/.ccpp/account.json.
| Command | |
|---|---|
ccpp account register --email <email> --name <name> | Create an account and log in. |
ccpp account login --email <email> | Log in and save a token. --password-stdin reads the password from stdin. |
ccpp account logout | Revoke this CLI's token and remove account.json. |
ccpp account whoami | Show the logged-in account. |
ccpp account update [--name n] [--email e] [--password] | Change your name, email or password. |
ccpp account tokens / revoke <id> | List the tokens of your account / revoke one. |
ccpp account delete --yes | Delete your account and all its tokens. |
--api-url (or $CCPP_API_URL) points to another API than https://api.ccpp.dev.
ccpp update
Updates ccpp from its source repository: fetches, pulls and recompiles the binary. The source tree must have no uncommitted changes.
ccpp update --check # only report whether new commits are available
ccpp update --force # rebuild even when already up to dateccpp marketplace
Writes the Claude Code marketplace of ccpp plugins. See How plugins work.
Environment variables
| Variable | Default | Meaning |
|---|---|---|
CCPP_HOME | ~/.ccpp | ccpp's home: config.yml, user policies and profiles, account.json. |
CCPP_API_URL | https://api.ccpp.dev | The ccpp.dev API used by ccpp account. |
Plugins read their own variables, such as CPO_LOG_DIR and CPO_STATE_DIR for CPO.