Troubleshooting

"command not found: contextkit"

Make sure you installed globally:

Or use npx: npx @nolrm/contextkit@latest install

"No ContextKit installation found"

You need to run ck install in your project directory first. Then you can add platform integrations.

Download failures during install

ContextKit downloads template files from GitHub. If you're behind a firewall or have network issues, try:

Hooks not running after cloning

For Node.js projects, run npm install — the prepare script sets up hooks automatically. For other projects:

Quality gates blocking push

To skip hooks for a single push:

To disable hooks permanently:

Legacy Husky conflicts

ContextKit automatically cleans up old Husky directories during install. If you still have issues, manually remove:

Cursor not reading rules

Make sure .cursor/rules/ exists. Run ck cursor to regenerate. Cursor reads .mdc files from this directory automatically.

Claude Code not loading standards automatically

ContextKit uses @path imports in CLAUDE.md to auto-load standards. Run /context in Claude Code to verify files are loaded. If not: (1) re-run ck claude to regenerate CLAUDE.md, (2) check that the first-time approval dialog was accepted (Claude Code prompts you to approve @imports on first use), (3) make sure the referenced .contextkit/standards/ files exist (run ck analyze to generate them).

Bridge file was overwritten

ContextKit uses marker comments (<!-- Generated by ContextKit -->) to manage its sections. If you have a custom CLAUDE.md or similar file, ContextKit appends below your content and only replaces its own marked section on updates.

Slash commands not appearing in Claude Code

Run ck claude to install slash commands to .claude/commands/. Restart Claude Code to pick up the new commands.

Slash commands not appearing in Cursor

Run ck cursor to install prompt files to .cursor/prompts/. These appear as slash commands in Cursor Chat.