A local agent harness

Lay the keel.
Raise the ribs.

Keelson is a single-user agent harness. It wraps a coding agent with persistent state, deterministic YAML workflows, and a typed extension contract. The harness is the keel, the part that ships, and it is useful on its own. Ribs are the capabilities you bolt on for more.

Read the Docs View on GitHub

Apache 2.0 · Beta · runs locally on Bun

A blueprint side elevation of a hull. The keelson beam is the harness; three brass frames rise from it, bolted to the beam, each labeled as a keelson-rib package. A midship section inset shows one rib bolted to the keelson. The CLI is the rudder, the browser SPA a surface, and a dashed superstructure (wheelhouse, mast, and rigging) marks structure still under construction.

Chat

Talk to the agent with every rib tool on tap.

Workflows

Deterministic runs as readable YAML.

Memory

Persistent, searchable, and governed.

Providers

Copilot, Claude, Codex, Pi. Swappable, no lock-in.

Surfaces

Ribs emit JSON; the app renders live boards.

Ribs

Capabilities ship as packages, not forks.

Where to start

Evaluate See what Keelson is, and what it is not. Try it, no paid keys Point a gateway at a local model with Ollama or vLLM. Automate a chore Turn repeatable work into a deterministic workflow. Add a capability Install a rib and light up a new surface. Run a real build One workflow builds an app, each phase on a different model. Script against it Drive the CLI and HTTP API with stable contracts.