charles-kit

Installer CLI for Charles Kit — a private Claude Code engineering toolkit.

This package contains only the installer CLI. The plugin source (agents, skills, hooks, rules) lives in a private GitHub repository. To use the kit, you need collaborator access — contact the maintainer.

Install

npx charles-kit install

Interactive prompt: global or per-project. Press Enter for global.

Non-interactive

npx charles-kit install --global      # force global, no prompt
npx charles-kit install --per-project # force per-project, no prompt
npx charles-kit install --yes         # skip prompt, default global

Commands

| Command | Purpose | |---|---| | install | Register marketplace + enable plugins | | uninstall | Remove Charles Kit (preserves other marketplaces) | | update | Refresh marketplace info | | doctor | Health check (binaries, schema, settings) | | doctor --active-plan | Debug "no active plan" errors | | cache clear | Clear impact-guard cache | | --help / --version | Help / version info |

What gets installed

The CLI writes to ~/.claude/settings.json (or ./.claude/settings.json with --per-project):

• Registers charles-kit marketplace pointing to the private GitHub repo
• Enables 4 plugins: charles-kit-core, charles-kit-skills, charles-kit-hooks, charles-kit-rules

Existing settings + other marketplaces are preserved. Backup written before any change.

After install

Restart Claude Code. The kit fetches the plugin source from the private GitHub repo. If you lack access:

Permission denied (publickey)
fatal: Could not read from remote repository.

→ Contact the maintainer to be invited as a collaborator. Once invited, ensure your SSH key is added to your GitHub account.

Requirements

• Node.js ≥18
• Claude Code installed
• Read access to the private GitHub repo (collaborator invite)
• SSH key configured for GitHub (recommended)

License

Proprietary (UNLICENSED). Internal use only.

Built on Claude Code.