CK CLI command deck

CLI Quick Reference

All 18 ClaudeKit CLI commands at a glance — flags, subcommands, and quick examples.

Quick reference for every ck command — copy to clipboard, explore flags and subcommands.

claudekit-cli v4.2.3

Commands

Setup & Install

5 Commands

ck new

Bootstrap a new ClaudeKit project with interactive version selection

--kit <engineer|marketing> -y, --yes --beta --use-git --dir <dir> -r, --release <version>

$ ck new --kit engineer --yes

Flag notes · 6 Open full explanations

--kit <engineer|marketing> Choose engineer, marketing, or all kit content.

-y, --yes Skip confirmation prompts for scripted runs.

--beta Use beta channel content or release.

--use-git Initialize the new project with Git metadata.

--dir <dir> Run setup against a specific directory.

-r, --release <version> Use a specific version instead of interactive selection.

ck init

Initialize or update ClaudeKit in an existing project

--kit <kit> -g, --global --fresh --force --install-skills -y, --yes --beta --sync -r, --release <version> --skip-setup

$ ck init -g --kit engineer --yes --install-skills

Flag notes · 10 Open full explanations

--kit <kit> Choose engineer, marketing, or all kit content.

-g, --global Apply to the user-level ClaudeKit install.

--fresh Reinstall cleanly instead of merging existing files.

--force Bypass soft safeguards where the command allows it.

--install-skills Install bundled skills during setup.

-y, --yes Skip confirmation prompts for scripted runs.

--beta Use beta channel content or release.

--sync Sync local ClaudeKit files with the selected kit.

-r, --release <version> Use a specific version instead of interactive selection.

--skip-setup Skip the interactive configuration wizard.

ck update

Update the ClaudeKit CLI tool itself to the latest version

--check -y, --yes -d, --dev -r, --release <version>

$ ck update --check

Flag notes · 4 Open full explanations

--check Check available updates without applying them.

-y, --yes Skip confirmation prompts for scripted runs.

-d, --dev Use development channel behavior where supported.

-r, --release <version> Use a specific version instead of interactive selection.

Notes

--beta is deprecated — use -d, --dev instead.
Updates CLI only. Use ck init to update kit content.

ck setup

Configure API keys and install optional packages

--global --skip-packages --dir <dir>

$ ck setup --global

Flag notes

--global Apply to the user-level ClaudeKit install.

--skip-packages Skip optional package setup steps.

--dir <dir> Run setup against a specific directory.

ck versions

List available ClaudeKit repository versions

--kit <kit> --limit <n> --all

$ ck versions --kit engineer --limit 10

Flag notes

--kit <kit> Choose engineer, marketing, or all kit content.

--limit <n> Limit how many entries are returned.

--all Include prereleases alongside stable versions.

Notes

Lists stable releases by default. Use --all to include prereleases.

Management

5 Commands

ck doctor

Comprehensive health check with auto-fix support

--fix --report --check-only --json --full

$ ck doctor --fix

Flag notes · 5 Open full explanations

--fix Apply safe automatic repairs when possible.

--report Write a diagnostic report instead of only console output.

--check-only Run checks only; do not repair issues.

--json Return machine-readable JSON output.

--full Run the most complete diagnostic pass.

ck config

Manage configuration and launch the dashboard UI

ui get set show -g, --global -l, --local --json --port <port> --host <host> --no-open --dev

$ ck config ui

Flag notes · 11 Open full explanations

ui Open the interactive configuration dashboard.

get Read one config value.

set Update one config value.

show Print the current config snapshot.

-g, --global Apply to the user-level ClaudeKit install.

-l, --local Apply to the current project install.

--json Return machine-readable JSON output.

--port <port> Choose the local dashboard server port. ui

--host <host> Bind dashboard to a specific host address. ui

--no-open Do not auto-open browser when launching dashboard. ui

--dev Use development channel behavior where supported. ui

Notes

Bare ck config opens dashboard (= ck config ui).

ck projects

Manage local project registry entries

list add remove --alias <alias> --pinned --tags <tags> --json

$ ck projects list

Flag notes · 7 Open full explanations

list Show saved entries.

add Register a new entry.

remove Delete an existing entry.

--alias <alias> Set a custom alias for the project entry. add

--pinned Pin this project for quick access. list, add

--tags <tags> Assign comma-separated tags to the entry. add

--json Return machine-readable JSON output.

ck backups

List, restore, and prune recovery backups

list restore prune --limit <n> --keep <n> --all -y, --yes --json

$ ck backups list

Flag notes · 8 Open full explanations

list Show saved entries.

restore Restore a specific backup to its original location.

prune Delete old or unnecessary backups.

--limit <n> Limit how many entries are returned. list

--keep <n> Keep the newest N backups when pruning. prune

--all Delete all recovery backups. prune

-y, --yes Skip confirmation prompts for scripted runs. restore, prune

--json Return machine-readable JSON output.

Notes

Covers CK-managed files only — not the full ~/.claude/ directory.

ck uninstall

Remove ClaudeKit installations safely with dry-run support

-l, --local -g, --global -A, --all -k, --kit <type> --dry-run --force-overwrite -y, --yes

$ ck uninstall --local --dry-run

Flag notes · 7 Open full explanations

-l, --local Apply to the current project install.

-g, --global Apply to the user-level ClaudeKit install.

-A, --all Target every supported item in that command scope.

-k, --kit <type> Choose engineer, marketing, or all kit content.

--dry-run Preview changes without writing them.

--force-overwrite Delete even user-modified managed files.

-y, --yes Skip confirmation prompts for scripted runs.

Notes

Preserves user-modified files by default. Use --force-overwrite to override.

Distribution

4 Commands

ck skills

Install/uninstall skills to 14+ coding agents (Cursor, Codex, etc.)

-n, --name <skill> -a, --agent <agents> -g, --global -l, --list --installed -u, --uninstall --search <query> --catalog --validate --sync -y, --yes

$ ck skills -n ui-ux-pro-max -a cursor --global

Flag notes · 11 Open full explanations

-n, --name <skill> Select one skill, agent, or command by name.

-a, --agent <agents> Choose destination provider or coding agent.

-g, --global Apply to the user-level ClaudeKit install.

-l, --list List available or installed items.

--installed Show only installed items.

-u, --uninstall Remove installed content from the target.

--search <query> Filter catalog results by query text.

--catalog Read from the bundled ClaudeKit catalog.

--validate Validate skill frontmatter fields.

--sync Sync local ClaudeKit files with the selected kit.

-y, --yes Skip confirmation prompts for scripted runs.

Notes

--installed shows two sections: active Claude Code skills (from .claude/skills/) and registry-managed agent installations.

ck agents

Install/uninstall Claude Code agents to other providers

-n, --name <agent> -a, --agent <providers> -g, --global -l, --list --all --sync -y, --yes

$ ck agents -l --installed

Flag notes · 7 Open full explanations

-n, --name <agent> Select one skill, agent, or command by name.

-a, --agent <providers> Choose destination provider or coding agent.

-g, --global Apply to the user-level ClaudeKit install.

-l, --list List available or installed items.

--all Target every supported item in that command scope.

--sync Sync local ClaudeKit files with the selected kit.

-y, --yes Skip confirmation prompts for scripted runs.

ck commands

Install/uninstall Claude commands to other providers

-n, --name <cmd> -a, --agent <providers> -g, --global -l, --list --all --sync -y, --yes

$ ck commands -l --installed

Flag notes · 7 Open full explanations

-n, --name <cmd> Select one skill, agent, or command by name.

-a, --agent <providers> Choose destination provider or coding agent.

-g, --global Apply to the user-level ClaudeKit install.

-l, --list List available or installed items.

--all Target every supported item in that command scope.

--sync Sync local ClaudeKit files with the selected kit.

-y, --yes Skip confirmation prompts for scripted runs.

ck migrate

Migrate agents, commands, skills, config, rules, hooks to providers

-a, --agent <providers> --all --install --reconcile --dry-run --only-* --skip-* --config --rules --hooks -g, --global -y, --yes --force --respect-deletions

$ ck migrate -a codex --dry-run

Flag notes · 14 Open full explanations

-a, --agent <providers> Choose destination provider or coding agent.

--all Target every supported item in that command scope.

--install Install migrated content on the target provider.

--reconcile Compare source and target before changing files.

--dry-run Preview changes without writing them.

--only-* Limit migration to specific content families.

--skip-* Exclude specific content families from migration.

--config Migrate CLAUDE.md config only.

--rules Migrate .claude/rules only.

--hooks Migrate .claude/hooks only.

-g, --global Apply to the user-level ClaudeKit install.

-y, --yes Skip confirmation prompts for scripted runs.

--force Bypass soft safeguards where the command allows it.

--respect-deletions Preserve deletions — skip auto-reinstall heuristic.

Notes

--install and --reconcile are mutually exclusive.
Codex commands migrate as skills under .agents/skills/.
-g now correctly resolves SOURCE to global scope (fixed in v4.2.0). Older versions read CWD even with -g.

Workflow

2 Commands

ck plan

Plan management: parse, validate, kanban board, and create plans

parse validate status kanban create check uncheck add-phase --json --strict -g, --global --title --phases

$ ck plan status

Flag notes · 13 Open full explanations

parse Read plan files and extract tasks.

validate Check plan structure before execution.

status Show current runtime or plan state.

kanban Open the visual plan board.

create Create a new plan from CLI input.

check Mark a plan task as complete.

uncheck Mark a plan task as incomplete.

add-phase Add another phase to a plan.

--json Return machine-readable JSON output.

--strict Fail validation on warnings instead of tolerating them. validate

-g, --global Apply to the user-level ClaudeKit install.

--title Set the generated plan title. create

--phases Set generated plan phase count or names. create

ck content

Multi-channel content automation with queue and approval flow

start stop status logs setup queue approve reject --dry-run --verbose --force --tail --reason <reason>

$ ck content status

Flag notes · 13 Open full explanations

start Start the automation service.

stop Stop the running service.

status Show current runtime or plan state.

logs Read recent runtime logs.

setup Prepare required config for this subsystem.

queue Inspect pending content jobs.

approve Approve queued content for publishing.

reject Reject queued content before publishing.

--dry-run Preview changes without writing them.

--verbose Print more detailed runtime output.

--force Bypass soft safeguards where the command allows it. start

--tail Follow live logs instead of printing once. logs

--reason <reason> Provide a reason for the rejection. reject

Notes

approve and reject require a content item <id>.

Integration

2 Commands

ck api

Interact with ClaudeKit API — vidcap, reviewweb, proxy services

setup status services vidcap reviewweb proxy --json --method --locale --format

$ ck api status

Flag notes · 10 Open full explanations

setup Prepare required config for this subsystem.

status Show current runtime or plan state.

services List API-backed services.

vidcap Use video capture or video summary features.

reviewweb Run web review helpers through the API.

proxy Use the configured proxy service.

--json Return machine-readable JSON output.

--method Choose API HTTP method. proxy

--locale Choose response language or locale.

--format Choose output format.

ck watch

Watch GitHub issues and auto-respond with AI analysis

--interval <ms> --dry-run --force --verbose

$ ck watch --dry-run --verbose

Flag notes · 4 Open full explanations

--interval <ms> Set polling interval for watchers.

--dry-run Preview changes without writing them.

--force Bypass soft safeguards where the command allows it.

--verbose Print more detailed runtime output.