# Install Kastra Edge

Install the correct platform build, sign in, and connect your agent hook.

Updated: 2026-09-22

Canonical: https://docs.kastra.ai/edge/install

## macOS

Install the CLI bundle with Homebrew:

```sh
brew install kastra-labs/tap/kastra-edge
```

The bundle includes `kastra-edge`, `kastrahook`, `kastra-mcp`, and `kastra-mcp-gateway`. Apple Silicon users can also [download the desktop app](https://kastra.ai/edge/download.html?platform=mac). Intel Macs use the CLI and hooks.

## Windows

With Scoop installed, run in PowerShell:

```powershell
scoop install git
scoop bucket add kastra https://github.com/kastra-labs/scoop-bucket
scoop install kastra-edge
```

The CLI supports x64 and ARM64. The [desktop installer](https://kastra.ai/edge/download.html?platform=windows) is x64. For an archive installation, choose the correct bundle from the [public releases](https://github.com/kastra-labs/kastra-edge-releases/releases), extract it, and add its directory to PATH.

## Linux

Download `kastra-edge-bundle-linux-amd64.tar.gz` or `kastra-edge-bundle-linux-arm64.tar.gz` from an exact [public CLI release](https://github.com/kastra-labs/kastra-edge-releases/releases). Verify its SHA-256 against a value obtained through a trusted channel before extraction; an adjacent checksum alone is not an independent signature. CLI archives are unsigned.

Extract into a new private directory and install the four executables (`kastra-edge`, `kastrahook`, `kastra-mcp`, `kastra-mcp-gateway`) into a user-owned directory on PATH. The Edge Homebrew formula is macOS-only. Linux has no desktop app or packaged daemon service; hooks do not require either. Upgrade by installing a reviewed exact-version archive.

## Sign in and select an environment

```sh
kastra-edge login
kastra-edge status
kastra-edge config set default_environment dev
```

Use an environment that exists in your workspace. Then follow the guide for [Claude Code](https://docs.kastra.ai/edge/claude-code), [Codex](https://docs.kastra.ai/edge/codex), [Cursor](https://docs.kastra.ai/edge/cursor), [OpenClaw](https://docs.kastra.ai/edge/openclaw), or [Hermes](https://docs.kastra.ai/edge/hermes). Installing the bundle does not install every agent hook.

## Verify and update

```sh
kastra-edge version
kastra-edge doctor
```

Restart the relevant agent after changing its configuration. Verify an allow, block, and HOLD with the [first-workflow checklist](https://docs.kastra.ai/start/first-workflow). Update Homebrew installations with `brew upgrade kastra-edge`, or Scoop installations with `scoop update kastra-edge`.

The desktop app can supply a different binary earlier on PATH. When an upgrade appears ineffective, inspect the resolved binary and its version. The [operator CLI](https://docs.kastra.ai/reference/cli) is a separate installation from the Linux Edge bundle.