ks — Keystone CLI

The official command-line client for Keystone — author and run agent-outcome evals, stream traces, and wire your project for evals in one command.

Install

curl -fsSL https://ks.polarity.so/install.sh | bash

Or pin a version:

curl -fsSL https://ks.polarity.so/install.sh | bash -s ks-v0.1.0

This drops the ks binary into ~/.local/bin/ (or /usr/local/bin/ if needed). After installing, run:

ks setup     # one-shot wizard: skills, MCP, starter spec, instrument, install SDK, snapshot guide, doctor
ks --help    # full command reference

What's in this repo

This repository hosts only the released binaries for the ks CLI. The source code lives in the private Keystone monorepo. Each tag (ks-vX.Y.Z) corresponds to a GitHub Release with prebuilt binaries for:

• darwin-amd64, darwin-arm64
• linux-amd64, linux-arm64

Each release includes a SHA256SUMS file for integrity verification.

Auto-update

Once installed, ks checks for new releases (cached for 24h) and self-updates transparently. Set KS_NO_AUTO_UPDATE=1 to opt out, or run ks update to upgrade on demand.

License

Proprietary — © Polarity Inc.