aitk-cli

v0.2.8

Published

15 days ago

Package manager for AI coding tools — install and share skills, MCPs, templates, configs and hooks for Claude Code, OpenCode, Gemini CLI and more.

Downloads

727

Quick Start

# Install a skill with npx (no install needed)
npx aitk-cli search "code review"
npx aitk-cli install official/code-review

# Or install globally
npm install -g aitk-cli
aitk search "memory"
aitk install official/memory-bank

What is AI Toolkit?

AI Toolkit is a package manager for AI coding tool artifacts. Think of it as npm, but for the prompts, skills, MCP servers, templates, and configurations that power your AI coding assistants.

Supported artifact types

| Type | Description | |------|-------------| | skill | Reusable prompts and workflows (slash commands) | | mcp | Model Context Protocol server configurations | | template | Project starter templates and boilerplates | | config | Tool configuration files and settings | | hook | Git hooks, pre/post-commit scripts |

Supported tools

Claude Code (Anthropic)
OpenCode
Gemini CLI
Cursor, Windsurf, and more

Commands

Registry

aitk search <query>              # Search the registry
aitk install <scope>/<name>      # Install an artifact
aitk update [scope/name]         # Update installed artifacts
aitk remove <scope>/<name>       # Remove an artifact
aitk publish                     # Publish your artifact

Project

aitk init                        # Initialize a new project
aitk init <scope>/<template>     # Initialize from a template
aitk list                        # List installed artifacts
aitk status                      # Check for available updates
aitk sync                        # Sync artifacts with the registry
aitk config                      # Manage CLI configuration

Teams

aitk team create <slug>          # Create a team
aitk team list                   # List your teams
aitk team add-member <slug> <user>  # Add a team member

Authentication

aitk login                       # Authenticate with the registry
aitk logout                      # Remove local credentials

Configuration

The CLI stores its configuration in ~/.aitk/:

~/.aitk/
  auth.json      # Authentication credentials
  config.json    # CLI settings (registry URL, default tool)

CI/CD Integration

Publish artifacts automatically with GitHub Actions:

# .github/workflows/publish.yml
name: Publish to AI Toolkit
on:
  release:
    types: [published]
jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: tarcisiojr/ai-toolkit/.github/actions/aitk-publish@main
        with:
          api-token: ${{ secrets.AITK_API_TOKEN }}

Shell Completions

# Bash
eval "$(aitk completions bash)"

# Zsh
eval "$(aitk completions zsh)"

# Fish
aitk completions fish | source