# Install

## Install

**macOS / Linux**

```bash
curl -fsSL https://getstream.io/cli.sh | bash
```

The script detects your OS, verifies the download's checksum, installs `getstream` to `~/.local/bin`, and adds that directory to your `PATH` if it isn't already there, telling you which shell profile it updated.

**Windows**

There is no native Windows build. Run the CLI inside [WSL](https://learn.microsoft.com/windows/wsl/install) instead: `wsl --install` in PowerShell, reboot, then open the Linux shell and follow the macOS / Linux steps.

## Verify

```bash
getstream --version
```

## Update

```bash
getstream update
```

Replaces the running binary in place with the latest stable release. To track a different release channel, set `STREAM_CLI_CHANNEL`.

Interactive runs also check for updates in the background and cache the result; when a newer release exists, the _next_ run prints a one-line notice on stderr pointing at `getstream update`. Nothing updates without you running the command, and non-interactive runs (scripts, CI, agents) never check or print the notice.

## Shell completion

```bash
getstream completion bash > /etc/bash_completion.d/getstream
getstream completion zsh  > "${fpath[1]}/_getstream"
getstream completion fish > ~/.config/fish/completions/getstream.fish
```

Run `getstream completion --help` for the full list.

## Agent skills

Install the Stream agent skills (`stream`, `stream-builder`, `stream-docs`) for your AI coding tool:

```bash
getstream skills --claude       # .claude/skills
getstream skills --universal    # .agents/skills (Cursor, Codex, AGENTS-ecosystem)
```

Restart your agent afterwards. Harnesses scan their skills directory at startup, so new skills don't appear until the next session. See [Install agent skills](https://getstream.io/cli/docs/install-skills/) for the full walkthrough.

## Related

- [Authenticate the CLI](https://getstream.io/cli/docs/authentication/): next step after installing
- [Uninstall](https://getstream.io/cli/docs/uninstall/): remove the CLI and everything it wrote

---

For the most recent version of this documentation, visit [https://getstream.io/cli/docs/installation/](https://getstream.io/cli/docs/installation/).