Installation

Shell installer (Linux / macOS)

The fastest way to install kedge:

curl -fsSL https://raw.githubusercontent.com/danielhirt/kedge/main/install.sh | sh

The installer detects your platform and downloads the latest release binary to /usr/local/bin.

Override the install directory:

curl -fsSL https://raw.githubusercontent.com/danielhirt/kedge/main/install.sh | KEDGE_INSTALL_DIR=~/.local/bin sh

Homebrew (macOS / Linux)

brew install danielhirt/tap/kedge

Pre-built binaries

Download from GitHub Releases. Binaries are available for:

Platform	Architecture
Linux	x86_64, aarch64
macOS	x86_64, aarch64
Windows	x86_64, aarch64

Each archive includes a .sha256 checksum file. Verify after download:

sha256sum -c kedge-linux-x86_64.tar.gz.sha256

From source

Requires Rust 1.70+ and git on PATH:

cargo install --path .

Or install directly from the repository:

cargo install --git https://github.com/danielhirt/kedge.git

Docker

Run kedge without installing anything locally:

docker run --rm -v "$PWD:/repo" -w /repo danielhirt/kedge check

Build the image from source:

docker build -t kedge .

CI runner setup

For air-gapped or pre-baked CI runners, copy the binary into your runner image:

COPY kedge /usr/local/bin/kedge

On developer machines, kedge install --link symlinks steering files from the docs repo to your local agent directories. In CI, kedge install --workspace copies them into the workspace.

Verify installation

kedge --help

You should see the list of available subcommands. Next, head to Quick Start to set up your first repository.