@smicolon/ai-kit

AI coding tool pack manager. Install convention packs (agents, skills, commands, rules, hooks) for any AI coding tool.

Install

Homebrew (macOS/Linux)

brew install smicolon/tap/ai-kit

Standalone Binary

curl -fsSL https://raw.githubusercontent.com/smicolon/ai-kit/main/scripts/install.sh | sh

Downloads a self-contained binary. Override install location with AI_KIT_INSTALL_DIR=~/.local/bin.

npm

npx @smicolon/ai-kit@latest init

Requires Node.js 22+.

Commands

init

Interactive first-time setup. Prompts for your AI tools, stack, and component preferences.

ai-kit init
ai-kit init --cwd apps/web  # monorepo sub-package

add <pack>

Add a pack to your project.

ai-kit add django
ai-kit add django --skills-only
ai-kit add django --agents-only
ai-kit add django --rules-only
ai-kit add django --tools claude-code,cursor

list

Show available or installed packs.

ai-kit list              # available packs
ai-kit list --installed  # installed packs

remove <pack>

Remove a pack and all its installed files.

ai-kit remove django

search <query>

Search packs by name or keyword.

ai-kit search auth
ai-kit search frontend
ai-kit search tdd

update [pack]

Update installed packs to latest versions.

ai-kit update          # update all
ai-kit update django   # update one

cache

Manage the local pack cache.

ai-kit cache clear     # force re-download on next run

Global Options

ai-kit --no-cache <command>      # skip cache, always fetch latest from GitHub
ai-kit --branch dev <command>    # use a specific branch (default: main)

How It Works

Packs are fetched from GitHub at runtime and cached locally at ~/.config/ai-kit/cache/. Every command checks for updates by comparing marketplace.json — if packs have changed upstream, they're re-downloaded automatically. No stale data when you're online.

Skills use a canonical + symlink strategy:

your-project/
├── .agents/skills/          # canonical copies
│   ├── import-convention-enforcer/
│   └── model-entity-validator/
├── .claude/skills/          # symlinks → .agents/skills/*
├── .cursor/skills/          # symlinks → .agents/skills/*
├── .claude/agents/          # copied .md files
├── .claude/commands/        # copied .md files
├── .claude/rules/           # copied .md files
├── .cursor/rules/           # converted .mdc files
├── .ai-kit.json             # tracks installed packs + files
└── .gitignore               # auto-updated

Tool preferences are stored globally at ~/.config/ai-kit/config.json (pick once, works in all projects). Local .ai-kit.json tracks installed packs and files for clean removal — it's auto-added to .gitignore.

Supported AI Tools

| Tool | Skills | Agents | Commands | Rules | Hooks | |------|:------:|:------:|:--------:|:-----:|:-----:| | Claude Code | yes | yes | yes | yes | yes | | Cursor | yes | - | - | yes (.mdc) | - | | Windsurf | yes | - | - | yes | - | | GitHub Copilot | yes | yes | - | - | - | | Codex | yes | yes | - | - | - | | Cline | yes | - | - | yes | - | | Continue | yes | - | - | yes | - | | Gemini | yes | yes | - | - | - | | Junie | yes | - | - | yes | - | | Kiro | yes | - | - | yes | - | | Amp | yes | yes | - | - | - | | Antigravity | yes | - | - | yes | - | | Augment | yes | - | - | yes | - | | Roo Code | yes | - | - | yes | - | | Amazon Q | yes | - | - | yes | - |

Available Packs

| Pack | Agents | Skills | Commands | Rules | |------|:------:|:------:|:--------:|:-----:| | django | 5 | 8 | 3 | 6 | | nestjs | 3 | 2 | 1 | 4 | | nextjs | 4 | 3 | 1 | 3 | | nuxtjs | 3 | 3 | 1 | 3 | | hono | 4 | 4 | 4 | - | | tanstack-router | 3 | 11 | 4 | - | | better-auth | 1 | 2 | 2 | - | | flutter | 3 | 3 | 5 | - | | architect | 1 | - | 1 | - | | dev-loop | - | 1 | 3 | - | | failure-log | - | 1 | 2 | - | | worktree | - | 1 | 1 | - | | onboard | 1 | 1 | 1 | - |

Monorepo Support

Use --cwd to target a sub-package. Both the sub-package and root .gitignore are updated.

ai-kit init --cwd apps/web
ai-kit add django --cwd apps/web

License

MIT