Skip to content

Vibe-code with discipline

koryph turns AI coding agents into a software factory. Point it at a git repo and it plans the work, runs a fleet of agents in parallel without merge conflicts, keeps them inside budget and policy, merges only what passes your gate — and ships signed, attested releases at the end. One static binary. No SaaS. Nothing to unsubscribe from.

Install · Quickstart · Features · Zero to shipped · How koryph compares · Download

Using an AI agent? Point it at llms.txt →


Why koryph exists

Tools like Claude Code changed the constraint. An AI agent writes a feature in minutes — so the bottleneck is no longer typing code, it is everything around the code: keeping five agents from trampling each other, keeping spend inside your subscription, keeping unreviewed changes off main, keeping commits signed and settings hardened, and turning the result into a release someone else can actually trust and install.

Vibe coding without that process is how you get a repo full of merge conflicts, a surprise bill, and an unshippable pile of code. Doing that process by hand is how you lose the speed you just gained.

koryph is the missing assembly line. It carries the process — planning, parallelism, review, budgets, hygiene, releases — so you and your agents can carry the ideas. It is opinionated about process, never about your application: no frameworks chosen for you, no folder layouts, no lock-in.

The three pillars

Build — the agent factory. koryph reads your project's task graph (beads), batches conflict-free work by each task's declared footprint, and dispatches headless agents into isolated git worktrees — in parallel, continuously, under the correct account. Finished work goes through review → rebase → your green gate → fast-forward merge. Nothing lands that doesn't pass.

Protect — hygiene as code. Branch-protection rulesets, repo settings, and security posture live as committed JSON you can check and apply (koryph repo check|apply), with named profiles like the built-in oss-solo-maintainer. Commit signing is enforced from vault-served keys. Protected paths keep agents away from your CI, hooks, and policy files. koryph doctor catches drift before it bites.

Ship — the release train. Conventional commits drive versioning for any language. Releases are draft-until-complete and immutable: binaries, checksums, SBOMs, cosign signatures, and SLSA build provenance all attach before anything publishes. A vault-backed release bot keeps PR checks flowing — with graceful fallbacks when you can't install one.

New in this release

  • koryph adopt — one command takes any existing repo to a fully-onboarded, validated project: detect → plan → consent → execute → verify. Adoption is now the ten-minute front door.
  • Intent routing — describe what you want built in a normal Claude session; koryph routes the ask through /koryph-design into a reviewed design doc and an implementable, conflict-aware bead graph.
  • Typed recovery, hardened — stall detection, a dead-agent patrol, evidence-bound bounded continuation and repair, and operator overrides that a running loop respects instead of clobbers (koryph merge --close-bead, koryph inject, koryph status --frontier).
  • Terminal cockpit, overhauled — a live activity tail of each agent's thinking and tool calls, structured stall flags, accurate fleet/quota readouts, and a queue that explains why every bead is or isn't dispatching.

The full history is in the CHANGELOG.

Datasheet

Feature What you get
Adopt koryph adopt wizard Any existing repo to a green koryph validate in one consented run; re-run any time as a health check
Plan Intent routing Work-shaped prompts route to the right planning command instead of ad-hoc implementation
Design funnel /koryph-design writes a repo-grounded design doc, stops for your approval, then decomposes it
Planning skills /koryph-plan, /koryph-import, /koryph-issue — designs, roadmaps, and prompts become a correctly-footprinted, dependency-aware task graph
Build Footprint scheduler Tasks declare what they touch; only conflict-free work runs in parallel — no merge-conflict roulette
Rolling dispatch Slots refill continuously as work finishes; the fleet never idles waiting for a "wave" to end
Worktree isolation Every agent works in its own git worktree; your checkout is never touched
Review pipeline Reviewer findings block the merge until addressed; then rebase, gate, fast-forward
Green gate Your own build/test/lint commands are the merge gate — if it's red, it doesn't land
Resource governor Beads declare machine demand (res:kind-cluster, res:docker); counted capacities keep two 6 GB dev stacks from ever co-dispatching
Cost governors Per-provider concurrency caps that adapt to rate limits (AIMD + circuit breakers), plus subscription-burn tracking and quota calibration
Typed recovery Stalls and failures are classified from evidence; safe continuations and standard-tier repairs are bounded, while hard faults block with a precise reason
Epic validation After an epic's last child lands, a validator vets the union against the design — gaps become follow-up beads, then a docs update, then the epic closes
Account safety Each project pins its account; identity is verified fail-closed before any dispatch
Multi-runtime Runtime-neutral core with portable tiers (frontier / standard / light); Claude Code and Codex are supported, while unimplemented adapters remain fail-closed
Protect Posture profiles Repo hygiene as named, applyable configuration — rulesets, settings, secret scanning, org-level rules
Signing, vault-served SSH commit signing with keys resolved on demand from Proton Pass, 1Password, macOS Keychain, or an encrypted file — never plaintext by default
Protected paths Merges that touch CI, hooks, or policy files are refused; a human lands those
Doctor One command reports drift across settings, signing, credentials, release infra, and DNS
Scanner fragments Opt-in gitleaks, vulnerability scanning, and license-allowlist presets
Ship Release train release-please + GoReleaser (or your own build commands) behind one contract that works for any language
Supply chain SBOM (SPDX), cosign keyless signatures, SLSA Build L3 provenance, immutable draft-until-complete releases — verifiable by anyone
Release bot A vault-backed bot identity provisioned in one browser click (koryph bot create) — a GitHub App or a GitLab access token, chosen per project — so Release PRs/MRs trigger checks unaided
Docs publishing Zensical/MkDocs book published to your forge's Pages (GitHub Pages, GitLab Pages) on every docs push, custom domain and HTTPS included
Operate Terminal cockpit koryph tui — live threads, burndown ETAs, event feed, governor/quota gauges, and an activity tail of each agent's thinking; plus board, roster, and a VS Code extension
Everything in the binary Provisioning, hygiene, validation, releases — a brew-style install is the complete product; scripts are shims

What koryph is not

  • Not a SaaS. There is no account, no telemetry, no server. Everything runs on your machine against your git remotes and your AI subscriptions.
  • Not a framework. koryph never chooses your language, layout, or dependencies. Delete koryph and your repo is still a perfectly ordinary repo — you lose the factory, not the product.
  • Not a replacement for judgment. The gate, the review stage, and protected paths exist precisely so that speed never outruns your standards.

Get started

Adoption is two commands and about ten minutes:

# 1. Install — single static binary, no runtime needed
brew install koryph/tap/koryph

# 2. Adopt any existing repo: the wizard detects what's missing, shows a
#    plan, asks consent, and finishes with a green `koryph validate`
koryph adopt ~/src/myproject

# 3. Describe what you want built (in an agent session), then run the loop
koryph run --project myproject --once --auto-merge --review

Continue with the quickstart, or read Zero to shipped for the full journey — plan, build, protect, release. Prefer to drive every step by hand? The wizard's lower-level verbs are all still there.

This book is layered so you can stop reading whenever you have enough: Features for the map, Concepts for the ideas, the user guide for operators and collaborators, and the developer guide for contributors to koryph itself.

Project

  • How koryph compares — the 2026 agent-orchestration landscape, honestly mapped.
  • Security — how koryph secures itself and your machines, and how to report a vulnerability.
  • Community & contributing — filing issues, contributing code, and the Apache-2.0 licensing model.

The name

koryph comes from the Ancient Greek κορυφαῖος (koryphaios) — the leader of the chorus in classical Greek drama. The koryphaios stood at the head of the chorus and spoke on its behalf whenever it took part in the action: one voice fronting many performers moving in step. The root κορυφή (koryphē) means "crest" or "summit", and the word lives on in several modern languages as a term for the leading figure in a field.

That is exactly this tool's job: one process fronting a fleet of autonomous coding agents — queueing their work, dispatching them in parallel, and speaking for them at the merge. It is pronounced KOR-iff.

For AI agents and tools: a machine-readable index of the canonical docs (llmstxt.org format) is published at /llms.txt — ingest it to map the project and its operating contract.