~ $ prompt your task AI Model AST ✓ Diff ✓ KYREX GATES Your Project

A local-first AI agent engineered for autonomous software engineering and systems administration.

See Kyrex in Action

Watch how Kyrex handles real-world development tasks with precision and safety.

Core Features

Every feature explained visually. No reading required.

code AST DIFF safe

Hardened Safety

AST gating rejects broken code before it touches disk. Diff gating requires explicit approval. Dangerous commands are hard-blocked.

fork merge active

Tree Mode

Branch your conversation context like Git. Fork experiments, checkout previous states, undo mistakes. Every path saved as portable JSON.

read edit now → → edit_file: refactor auth reason: "remove deprecated"

Flight Recorder

Thread-safe auditing maps exactly why the model executed specific tools. Persistent reasoning logs anchored to each interaction.

PLAN read-only EXECUTE autonomous

Dual Modes

Toggle between Plan (read-only advisory) and Execute (autonomous code writing). Context compaction at 80% token threshold.

kx — terminal $ / setup /model change model /autoapprove set delay → Provider set: OpenAI

Interactive UX

Slash-command autocomplete (/), inline model browser (/model), and full setup wizard (/setup). Ctrl+Y to copy last response.

MCP git api db search infra custom

MCP Support

Built-in hooks for Model Context Protocol. Pull in external tools, infrastructure tracking, or search APIs.

call 1 call 2 call 3 ABORT max 10 rounds

Circuit Breaker

After 3 consecutive tool failures, Kyrex aborts to prevent infinite reasoning loops. Maximum 10 nested tool-call rounds.

1 2 3 4

Race Mode

Fire the same task at multiple models in parallel. Compare diffs side-by-side, merge the best result. Max 4 lanes — no prompt engineering needed.

primary consult consult 1-2 helpers

Consult Mode

Summon 1–2 helper models mid-session for a focused second opinion without derailing the main conversation.

original clone workspace COW

Sandboxed Workspace

Every session operates on a copy-on-write clone. File edits are isolated until you approve them — if the agent goes rogue, nothing hits your project tree.

PLAN EXEC TOOLS DONE 2.3s

Execution Timeline

Live visual trace of every phase — Plan → Execute → each tool call. Status icons, timing, and a full mission summary. No black box.

edit read read_file → 0.04s ✓

Tool Telemetry

Ring-buffer history of every tool invocation with timing and result status. See what the agent did, how long it took, and whether it succeeded.

Diff Gate

No changes land silently. Every file modification is staged and requires explicit human approval.

model edit diff preview - for item in items: - total += item.price + total = sum(...) return total * tax_rate approve ✓ applied ✓

Trust Mode

For high-confidence workflows. Auto-accept edits after a brief review window.

1 edit proposed 2 2.5s review window 3 auto-accept ✓

Set in-terminal: /autoapprove — or /autoapprove 5 for a custom delay.

Supported Providers

Bring your own API key. Works with any OpenAI-compatible endpoint.

OpenAI

GPT-5, o-series reasoning

Anthropic

Claude Opus/Sonnet 4.x

Custom

Any OpenAI-compatible API

Bring Your Own Key

Your API keys, your models, your infrastructure. No vendor lock-in.

your key pick model gpt-4o ▼ claude-sonnet local only ✓

✓ Full Control

Use your own API keys directly. No middleman, no markup, no data collection.

✓ Any Model

Switch between GPT-4o, Claude, or any OpenAI-compatible endpoint on the fly.

✓ Local First

Runs entirely on your machine. Sessions stored locally as portable JSON.

✓ Custom Endpoints

Point to Azure OpenAI, local LLMs, or any compatible API with custom base URLs.

Benchmarks

Kyrex vs leading coding agents — head-to-head performance on real coding tasks.

Kyrex Benchmarks

Get Started

One command. Linux/WSL.

curl -fsSL https://raw.githubusercontent.com/kp84-hub/kyrex/main/install.sh | bash

Then run the interactive setup wizard to configure your provider and model:

kx --setup

Or install manually:

# Clone and install
git clone https://github.com/kp84-hub/kyrex.git
cd kyrex
pip install -e kyrex_engine/ --break-system-packages
go build -o kx .
sudo cp kx /usr/local/bin/kx

# Configure and launch
kx --setup
kx

Requirements: Go 1.21+, Python 3.11+

Get VS Code Extension →