Commands Reference

Reference for ContextKit CLI commands. Use ck as a short alias for contextkit.

New to ContextKit?

Installation and project setup are covered in the Quick Start guide.

Install

contextkit install

Set up ContextKit in the current project: standards, AGENTS.md, platform files, skills, and git hooks. Writes the always-on headline block unless you skip it. Add a single platform later with ck claude, ck codex, ck cursor, and so on.

contextkit installcontextkit install --no-headline

Options:

--no-headline - Skip the always-on headline response-style block
--no-hooks - Skip git hooks installation
--non-interactive - Skip interactive prompts
--force - Regenerate user-owned standards files even if they already exist

Updates & Maintenance

contextkit update

Update ContextKit commands, hooks, skills, and platform files to the latest version. Only touches content inside ContextKit markers; your standards and own content are preserved. Exits early when you're already on the latest version. If it prints "N item(s) need a decision", run /ck update in Claude Code or Codex.

contextkit updatecontextkit update --force

Use --force (or ck <platform>) to regenerate files without a new version, for example after editing context_rules or headline in .contextkit/config.yml. See Upgrading to 2.0.

Global Skills

contextkit install --global

Install the add-on skills to ~/.claude/skills/ so they work in every project, with or without ContextKit. Omit the name to install both.

contextkit install --global goalcontextkit install --global headline

contextkit update --global

Regenerate the installed global skills and remove retired pre-2.0 ones.

contextkit update --global

contextkit uninstall --global

Remove contextkit-managed global skills. Never removes a same-named skill you wrote yourself. A bare ck uninstall --global only lists what is installed. Accepts old pre-2.0 names so you can clean up.

contextkit uninstall --global headlinecontextkit uninstall --global --all

Options:

[name] - Skill or family: goal, headline, or a retired pre-2.0 skill name (see Upgrading to 2.0)
--all - Remove every contextkit-managed global skill

Status & Health

contextkit status

Check installation status and verify which context files are present and configured.

contextkit status

contextkit check

Validate your ContextKit installation and check that all expected files are in place. Also runs the stale-context check: instructions that point at missing files or removed skills, and always-loaded context over context_budget_lines (default 400).

contextkit checkcontextkit check --context

Options:

--strict - Treat warnings as errors
--verbose - Show detailed information
--context - Only run the stale-context check (the pre-push hook runs this as a non-blocking warning)
--quiet - Print nothing when there is nothing to report
--global - Report on installed global skills instead

Analysis

contextkit analyze

Analyze your project and generate customized standards based on your actual codebase. Monorepo-aware: Automatically detects and prompts for frontend/backend scope.

💡 Prefer /ck setup in your AI tool — it reads your codebase and writes the standards, index.md, and context_rules without leaving the editor.

contextkit analyze

Options:

--scope frontend|backend|both - Analyze specific scope (non-interactive)
--package <path> - Analyze specific package (e.g., apps/admin)
--non-interactive - Skip prompts

📦 Monorepo Support:

For monorepos, automatically detects packages and prompts to analyze frontend, backend, or both. Generates separate standards when analyzing both.

Skill Usage

contextkit usage

Show which skills actually get used, read from local Claude Code and Codex session logs: loaded by the model vs typed by you, per tool, and when each was last used. Nothing leaves your machine.

contextkit usagecontextkit usage --days 30 --all

Options:

--days <days> - Look back this many days (default 90; 0 = all)
--all - Include every project, not just this one
--json - Output JSON

Corrections Logging

contextkit note

Add entries to the corrections log for tracking AI performance issues and improvements. The /learn skill calls this for you when it turns a correction into a rule.

contextkit note "prefer async/await over promise chains"

Options:

--category <category> - Category (AI Behavior, Preferences, etc.)
--priority <priority> - Priority (HIGH, MEDIUM, LOW)
--task <task> - Related task description

Example: ck note "always use named exports" --category "Preferences" --priority LOW

Short Alias Available

Use ck instead of contextkit for faster typing. Example: ck install, ck update, ck check

MD-First Development

Slash Commands

Was this helpful?

Help us improve the documentation by sharing your feedback.