CLI reference

The ClaudeKit CLI ships as the npm package claudekits and installs two binaries: claudekit and the short alias ck. Every example below uses ck. Install it with npm i -g claudekits (see Installation).

Global flags

These work on every command:

Flag	Effect
`--json`	Emit machine-readable JSON instead of formatted tables (`list`, `tokens`, `doctor`, and friends).
`--no-color`	Disable ANSI colour in output (also respects the `NO_COLOR` env var).
`-v`, `--version`	Print the CLI version.
`--help`	Print usage for the CLI or a specific command.

Exit codes

Every command exits non-zero on failure with an actionable message, so ck is safe to script:

Code	Meaning
`0`	Success.
`1`	General failure (bad arguments, kit not found, invalid or revoked license, file conflict).
`2`	Activation limit reached.
`3`	Network failure (API or download unreachable).

`ck auth`

ck auth <license-key>

Validate your license key via theclaudekit.com/api/license/validate, register this device as an activation, and cache your credentials in ~/.claudekit/config.json.

ck auth ck_xxxxxxxxxxxxxxxxxxxx

bash

Exits 1 if the key is invalid or revoked, 2 if it is over its activation limit. See License validation.

`ck whoami`

ck whoami

Print the account the cached credentials belong to and the kits your license unlocks. Reads ~/.claudekit/config.json — fully offline.

ck whoami

bash

Exits 1 if you are not authenticated.

`ck list`

ck list [--json]

List the kits your license owns, their latest versions, and whether each is installed (and where). ck ls is an accepted alias.

ck list
ck list --json

bash

`ck install`

ck install <kit> [-l|--local] [-f|--force]

Re-validate your license (without consuming an activation), download the kit's versioned release zip from the ClaudeKit API, copy the files into Claude Code's commands/, skills/, and agents/ directories, and print the token ledger from the kit's manifest.json. ck add is an accepted alias.

Flag	Effect
`-l`, `--local`	Install into the project-local `./.claude/` instead of the global `~/.claude/`.
`-f`, `--force`	Reinstall even if the same version is already installed.

ck install seokit            # global install   → ~/.claude/
ck install seokit --local    # project install  → ./.claude/
ck install seokit --force    # reinstall over an existing copy

bash

Using a kit is fully offline after the download completes. Exits 1 if your license does not unlock the kit, 3 if the download fails.

`ck update`

ck update [kit] [-f|--force]

Diff your installed kit(s) against the latest entitled version and apply the update. Omit the kit name to check all installed kits. ck upgrade is an accepted alias.

ck update            # update everything installed
ck update seokit     # update just SEOKit

bash

`ck uninstall`

ck uninstall <kit> [-l|--local]

Cleanly remove a kit, deleting only the files recorded in its install receipt (your artifacts and any unrelated files are left untouched). ck remove is an accepted alias. Use -l/--local to target a project-local install.

ck uninstall seokit

bash

`ck tokens`

ck tokens [kit] [--live] [--json]

The edge. Print the per-file context token ledger — every command, skill, and agent with its measured cost, sorted by cost, plus the total budget impact as a share of the 200k context window. Omit the kit name to summarize every installed kit.

Flag	Effect
`--live`	Recount tokens from the local files on disk and show drift vs the manifest's baked-in numbers.
`--json`	Emit the table as JSON for scripting.

ck tokens seokit
ck tokens seokit --live
ck tokens --json

bash

Sample output:

Token ledger
  FILE                              KIND     TOKENS  % OF 200K
  skills/seo-writing/SKILL.md       skill     1,936       1.0%
  skills/seo-data/SKILL.md          skill     1,118       0.6%
  skills/seo-aeo/SKILL.md           skill     1,034       0.5%
  …
  commands/seo-audit.md             command     844       0.4%
  agents/seo-auditor.md             agent       612       0.3%
 
Total: 16,004 tokens  (8.0% of the 200k context window)
Skill files (SKILL.md) are always-loaded; agents/commands load on demand.

`ck doctor`

ck doctor

Run environment and health checks: Node.js version, Claude Code present, ~/.claude (and ./.claude) permissions, credentials valid, API reachable, installed-kit integrity, orphaned files, and the always-loaded token budget (it warns above 25,000 tokens).

ck doctor

bash

Attach the output when you contact Support.