@crewkit/cli

Manage your team's Claude Code agents from the terminal. Sync role-based configs and track what's working - all CLI-first. A/B experiments live in the dashboard at https://crewkit.io.

Quick Start

curl -fsSL https://crewkit.io/install.sh | sh
crewkit auth login
crewkit

That's it. Your team's agent configurations are now synced.

Why crewkit?

• Team consistency: One source of truth for agent configurations across your org
• Role-based modes: Junior devs get coaching mode, seniors get autonomy
• A/B testing built-in: Experiment with prompts, measure what works
• Works with your workflow: CLI-first, integrates with your existing tools

Commands

| Command | Description | |---------|-------------| | crewkit | Start a coding session — launches Claude Code with your team's agent configs | | crewkit code | The same launch under its explicit name | | crewkit tui | The same session inside crewkit's terminal interface (live sidebar) | | crewkit -p "prompt" | Headless mode for scripting and CI | | crewkit auth login | Authenticate with crewkit | | crewkit auth status | Check authentication status |

Features

For Individual Developers

• Automatic agent sync when you run crewkit
• Session history and metrics tracking
• Works in any git repository

For Teams

• Role-based modes (coaching for juniors, autonomy for seniors)
• Centralized configuration management
• A/B testing framework for prompt optimization
• Usage analytics and cost tracking

Installation

Shell Script (recommended)

curl -fsSL https://crewkit.io/install.sh | sh

npm

npm install -g @crewkit/cli

Homebrew (macOS/Linux)

brew install karibew/tap/crewkit

Windows — use WSL

wsl npm install -g @crewkit/cli

This package ships no native Windows binary: those builds are paused. On native Windows npm install -g @crewkit/cli still installs — and says so — but the CLI refuses to run and points you here. The Chocolatey package (choco install crewkit) is frozen at 0.4.1 and no longer follows releases. WSL is the better target anyway — background observation is Unix-only.

Direct Download

See GitHub Releases for platform-specific binaries.

Shell completions

Tab completions for bash, zsh, fish, and PowerShell (Homebrew installs them automatically):

# bash
echo 'source <(crewkit completions bash)' >> ~/.bashrc

# zsh — add fpath+=~/.zfunc to ~/.zshrc before compinit
mkdir -p ~/.zfunc && crewkit completions zsh > ~/.zfunc/_crewkit

# fish
mkdir -p ~/.config/fish/completions && crewkit completions fish > ~/.config/fish/completions/crewkit.fish

crewkit completions --help has the full per-shell setup, including PowerShell.

Supported Platforms

• macOS Apple Silicon (M1/M2/M3/M4)
• Linux x64
• Windows x64 — via WSL (install the Linux build there)

Not published: macOS Intel, and native Windows (paused).

Requirements

• Node.js 18+ (for npm installation)
• Git (for project detection)
• A crewkit account (sign up free)

Troubleshooting

"Cannot connect to crewkit API"

• Check your network connection
• Verify authentication: crewkit auth status

"No agent configurations found"

• Ensure you're in a git repository
• Check that your org has configured agents at app.crewkit.io

Binary not found after install

• Try reinstalling: npm install -g @crewkit/cli --force
• Check if --no-optional flag was used (platform binaries are required)

Privacy & Telemetry

crewkit collects anonymous error reports via Sentry to improve reliability. No code, prompts, or personal data is collected. You can disable telemetry by setting either of these in your environment:

export CREWKIT_NO_TELEMETRY=1

DO_NOT_TRACK=1 is honoured too. With either set, no Sentry client is initialized at all — nothing is sent.

See our Privacy Policy for details.

Documentation

• Getting Started Guide
• CLI Reference
• API Documentation

Links

• Website
• GitHub
• Changelog

License

See Terms of Service for license details.