@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-optionalflag 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
Links
License
See Terms of Service for license details.