---
source: CrewKit documentation
url: https://crewkit.io/docs/installation.md
title: "Installation"
description: "Install the crewkit CLI on macOS, Linux, or Windows via WSL."
---


Install the crewkit CLI to start managing your team's AI coding sessions.

import { Tab, Tabs } from 'fumadocs-ui/components/tabs';

<Tabs items={['Homebrew', 'npm', 'curl']}>
<Tab value="Homebrew">
```bash
brew install karibew/tap/crewkit
```
</Tab>
<Tab value="npm">
```bash
npm install -g @crewkit/cli
```
</Tab>
<Tab value="curl">
```bash
curl -fsSL https://crewkit.io/install.sh | sh
```
</Tab>
</Tabs>

Verify the installation:

```bash
crewkit --version
```

---

## Prerequisites

- **Claude Code** (`claude` on your PATH) — required only for `crewkit code`, which launches an observed session. `crewkit auth login`, `crewkit init` and `crewkit mcp serve` do not need it.
- **Git** — crewkit detects your project from the git remote
- **Node.js 18+** (if installing via npm)

---

## Platform notes

**macOS** — Homebrew is the recommended install method. Apple Silicon (arm64) is supported; Intel (x64) builds are not yet available.

**Linux** — Use the curl installer or npm. Builds are available for x64.

**Windows** — Use WSL and install the Linux build with any command above. Native Windows builds are paused, so the Chocolatey package is frozen at 0.4.1 and npm no longer ships a Windows binary. WSL also enables background observation, which is Unix-only.

---

## Updating

```bash
crewkit update
```

To check for updates without installing:

```bash
crewkit update --check
```

For script-installed binaries, crewkit also checks for updates in the background (at most hourly) and installs them automatically after verifying the release signature; set `CREWKIT_NO_AUTO_UPDATE=1` to disable. Installs owned by Homebrew, npm, or Chocolatey are never touched — crewkit tells you the right package-manager command instead.

---

## Next steps

- [Quickstart: your first session](/docs/quickstart)
- [Configuration](/docs/configuration)