Docs
DocumentationCoding agents

Install Kastra Edge

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

Updated 2026-09-22 Read as Markdown
On this page

macOS

Install the CLI bundle with Homebrew:

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. Intel Macs use the CLI and hooks.

Windows

With Scoop installed, run in 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 is x64. For an archive installation, choose the correct bundle from the public 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. 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

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, Codex, Cursor, OpenClaw, or Hermes. Installing the bundle does not install every agent hook.

Verify and update

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. 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 is a separate installation from the Linux Edge bundle.