| title |
CLI Reference |
| category |
reference |
| service |
ai-toolkit |
| tags |
cli |
commands |
reference |
install |
update |
plugin |
mcp |
telemetry |
|
| created |
2026-04-13 |
| last_updated |
2026-04-24 |
| description |
Complete CLI reference for all ai-toolkit commands, options, and flags. |
Usage: ai-toolkit <command> [options]
| Command |
Description |
install |
First-time global install into ~/.claude/ + Cursor, Windsurf, Gemini |
install --local |
Claude Code configs only; add --editors all or --editors cursor,aider for other tools |
update |
Re-apply toolkit after npm install -g @softspark/ai-toolkit@latest |
update --local |
Re-apply + auto-detect editors from existing project files |
reset --local |
Wipe all project-local configs and recreate from scratch (clean slate) |
status |
Show installed modules and version |
uninstall |
Remove toolkit from ~/.claude/ |
validate |
Verify toolkit integrity (--strict for CI-grade, warnings = errors) |
doctor |
Diagnose install health, hooks, quick-win assets, and artifact drift |
doctor --fix |
Auto-repair broken symlinks, missing hooks, stale artifacts |
eject [dir] |
Export standalone config (no symlinks, no toolkit dependency) |
| Command |
Description |
add-rule <rule.md|url> [name] |
Register rule in ~/.softspark/ai-toolkit/rules/ — auto-applied on every update |
remove-rule <name> [dir] |
Unregister rule and remove its block from CLAUDE.md |
inject-hook <file.json|url> [name] |
Inject external hooks (file or URL) into settings.json (idempotent, _source tagged, URL hooks auto-refresh on update) |
remove-hook <name> |
Remove injected hooks by source name (also unregisters URL source if present) |
| Command |
Description |
mcp list |
List available MCP server templates (26 templates) |
mcp editors |
List editors with native MCP config adapters and scopes |
mcp add <name> [names...] |
Add MCP server template(s) to .mcp.json |
mcp install --editor <name[,..]> [names...] |
Install templates into native editor MCP config |
mcp show <name> |
Show MCP template config details |
mcp remove <name> |
Remove MCP server from .mcp.json or editor MCP config |
| Command |
Description |
plugin list |
Show available plugin packs with install status |
plugin install <name> [--editor claude|codex|all] |
Install a plugin pack for selected runtime(s) |
plugin install --all [--editor claude|codex|all] |
Install all 11 plugin packs |
plugin update <name> [--editor claude|codex|all] |
Update a plugin pack (remove + reinstall, preserves data) |
plugin update --all [--editor claude|codex|all] |
Update all installed plugin packs |
plugin clean <name> [--days N] |
Prune old plugin data (default: 90 days) |
plugin remove <name> [--editor claude|codex|all] |
Remove a plugin pack |
plugin status [--editor claude|codex|all] |
Show installed plugins with runtime-specific details |
| Command |
Description |
config validate [path] |
Validate .softspark-toolkit.json schema + extends + enforcement |
config diff [path] |
Show project vs base config differences |
config init [flags] |
Create .softspark-toolkit.json (--extends, --profile, --no-extends) |
config create-base <name> |
Scaffold base config npm package |
config check [path] |
CI enforcement gate (exit 0=pass, 1=fail, 2=no config; --json) |
| Command |
Description |
projects |
List registered projects |
projects --prune |
Remove stale (deleted) entries |
projects remove /path |
Unregister specific project |
| Command |
Description |
generate-all |
Generate all platform configs at once |
agents-md |
Regenerate AGENTS.md from agent definitions |
codex-md |
Generate AGENTS.md (coding rules inlined) with marker injection for Codex CLI |
codex-hooks |
Generate .codex/hooks.json for Codex CLI |
cursor-rules |
Generate .cursorrules (legacy single file) |
cursor-mdc |
Generate .cursor/rules/*.mdc (recommended) |
windsurf-rules |
Generate .windsurfrules (legacy) |
windsurf-dir-rules |
Generate .windsurf/rules/*.md (recommended) |
copilot-instructions |
Generate .github/copilot-instructions.md |
gemini-md |
Generate GEMINI.md for Gemini CLI |
cline-rules |
Generate .clinerules (legacy) |
cline-dir-rules |
Generate .clinerules/*.md (recommended) |
roo-modes |
Generate .roomodes |
roo-dir-rules |
Generate .roo/rules/*.md |
aider-conf |
Generate .aider.conf.yml |
conventions-md |
Generate CONVENTIONS.md for Aider |
augment-rules |
Generate .augment/rules/ai-toolkit.md (legacy) |
augment-dir-rules |
Generate .augment/rules/ai-toolkit-*.md (recommended) |
antigravity-rules |
Generate .agents/rules/ and .agents/workflows/ |
llms-txt |
Generate llms.txt and llms-full.txt |
| Command |
Description |
stats |
Show skill usage statistics (--summary for product telemetry, --reset to clear, --json for raw output) |
benchmark --my-config |
Compare your config vs defaults vs ecosystem |
benchmark-ecosystem |
Generate ecosystem benchmark snapshot |
create skill <name> |
Scaffold new skill from template (--template=linter|reviewer|generator|workflow|knowledge) |
sync |
Config portability via GitHub Gist (--export, --push, --pull, --import) |
compile-slm |
Compile toolkit into minimal SLM system prompt (--budget, --model-size, --dry-run) |
evaluate |
Run skill evaluation suite |
ai-toolkit stats # table of local skill usage
ai-toolkit stats --summary # product telemetry summary
ai-toolkit stats --summary --json # machine-readable telemetry
ai-toolkit stats --reset # clear local stats
--summary reports total invocations, unique skills used, catalog coverage, unused catalog skills, active skills in the last 7 days, and top skills. Data stays local in ~/.softspark/ai-toolkit/stats.json.
ai-toolkit install --only agents,hooks # apply only listed components
ai-toolkit install --skip hooks # skip listed components
ai-toolkit install --profile minimal # minimal | standard | strict
ai-toolkit install --persona backend-lead # backend-lead | frontend-lead | devops-eng | junior-dev
ai-toolkit install --local --editors all # Claude Code + all editors
ai-toolkit install --local --editors cursor,aider # + specific editors
ai-toolkit install --local --lang typescript # explicit language rules
ai-toolkit install --modules core,agents,rules-typescript # selective modules
ai-toolkit install --list # dry-run: show what would change
ai-toolkit update --local # auto-detects editors from existing files