@softspark/ai-toolkit weekly downloads statistics

ai-toolkit

AI coding toolkit with machine-enforced safety, 116 skills, 44 agents, lifecycle hooks, persona presets, opt-in plugin packs, and benchmark tooling.

What's New in v5.4.1

• llm-status says when to retry a rate-limited account. A refused usage read shows Unavailable: rate_limited, retry in 40m from the provider's Retry-After header (retry_after_seconds in JSON), once per account.
• The last DeepSeek Harness (DSH) code is gone (v5.4.0). ai-toolkit dsh is an unknown command and --editors dsh an unknown editor; the toolkit no longer migrates old DSH project skills or registry entries. Run ai-toolkit update once on 5.3.5 first if a project still carries them, see the removal note.
• inject-mcp reaches every Claude Code profile (v5.4.0). Injected servers such as rag-mcp are written to each claude-switch profile, like mcp install does; remove-mcp and uninstall clean them there too.
• No orphaned ## Project Constitution heading (v5.3.5). It now leaves CLAUDE.md together with its import; update removes one an older release left, and adopt-agents-md no longer keeps it.
• update names projects with instructions only in CLAUDE.md (v5.3.4). Agents other than Claude Code do not read that file; the list ends the update with the ai-toolkit adopt-agents-md fix. An untouched older template is now recognized and moved to AGENTS.md.
• Current models (v5.3.4). Skills and defaults reference Claude Haiku 5.5 and Sonnet 5.5, and the Codex reference adds GPT-6.1 Sol.
• The npm package no longer ships an AGENTS.md (v5.3.3). It was the toolkit's generated core, which nothing in the package read; ai-toolkit agents-md still prints it. This repository now keeps its own instructions in a committed AGENTS.md, like every toolkit-installed project.
• Global first, then the project (v5.3.2). install --local installs everything a client can load from $HOME before the project files, using the recorded global profile; --no-global opts out, and update keeps the profile.
• Generated AGENTS.md stays out of CLAUDE.md (v5.3.1). A toolkit-generated AGENTS.md (# AI Toolkit Instructions) is no longer imported, so Claude does not load rules from ~/.claude/rules/ twice; adopt-agents-md refuses to merge into it.
• One AGENTS.md for every agent (v5.3.0). Project instructions live in a committed AGENTS.md that CLAUDE.md imports; ai-toolkit adopt-agents-md moves an existing CLAUDE.md there, and nothing truncates it (Codex project_doc_max_bytes raised, 24,000-byte Antigravity warnings).
• Working Antigravity hooks and rules. Hooks run from the hooks.json directory and gate only run_command; workspace rules carry trigger frontmatter and fit Antigravity's size limits.
• MCP rules follow the client's MCP config. Registered rules that need an MCP server reach a file only when its readers have that server; rag-mcp-legal-rules is opt-in. Global Claude MCP installs reach every claude-switch profile.

See CHANGELOG.md for full history.

Table of Contents

• Install
• Platform Support
• What You Get
• Architecture
• Key Features
• Key Slash Commands
• Getting Started
• Documentation
• Contributing
• Security
• License
• Changelog

---

Install

Requirements: Node.js >= 18 and Python >= 3.11.

macOS: /usr/bin/python3 is Python 3.9 and will not run the toolkit. Install a supported one with brew install python@3.13 and make sure which python3 no longer points at /usr/bin/python3.

# Option A: install globally (once per machine)
npm install -g @softspark/ai-toolkit
ai-toolkit install

# Option B: try without installing (npx)
npx @softspark/ai-toolkit install

That's it. Claude Code picks up 116 skills, 44 agents, quality hooks, and the safety constitution automatically.

Language knowledge skills (rust-rules, kotlin-patterns, ...) are scoped to the languages your registered projects use: once you have run ai-toolkit install --local in at least one project, the global install turns the other languages' skills off through skillOverrides in ~/.claude/settings.json so their descriptions stop loading into every session. A new project in a new language turns its skills back on. ai-toolkit install --language-skills all keeps every language skill on and remembers that choice; ai-toolkit doctor shows the resulting context budget.

Windows: WSL is the recommended runtime. Native Windows works when Git Bash is available for hook scripts; dependency hints cover winget, Chocolatey, and Scoop. See Windows Support.

Update

npm install -g @softspark/ai-toolkit@latest && ai-toolkit update

Per-Project Setup

cd your-project/
ai-toolkit install --local                        # Claude Code only
ai-toolkit install --local --editors all          # + all editors
ai-toolkit install --local --editors cursor,aider # + specific editors
ai-toolkit update --local                         # auto-detects editors

All LLM Accounts…