Keelokit

Open source · a Claude Code harness

The keel under my apps.

Claude Code writes code. Keelokit makes it work like a disciplined team: it writes things down, tests, reviews itself and ships nothing without your OK.

For startups and teams who want a first MVP built right, and for anyone starting out with agents. It’s the method I use on my own projects.

Orchestrating sessions that can’t see each other? Keelokit Harbor is the other plugin

Latest release: v0.13.0 · Nov 2, 2026 · What’s new · Download .zip

What you build rides on top. What keeps it on course sits underneath.

−2 m

Claude Code can code. What it lacks is a method.

Keelokit is the playbook you install in it, like the one you’d hand someone joining your team: the same stages, the same rules, and someone who checks every delivery.

Claude Code on its own

Ask it to “build me an app” and it will. Its own way each time, with nothing written down, and the one who built it tells you it’s ready.

With Keelokit

First it understands what you want and writes it down. Then it builds in small pieces, with tests, with another agent reviewing and another trying to break it. You approve what matters.

−4 m

From an idea to a published app, in seven steps.

You your part: answer and approve Claude does it on its own

  1. 01

    Interview

    It asks about your idea and writes down what problem it solves, for whom and under which rules. What nobody knows yet stays as an open question.

    YouClaude
  2. 02

    PRD

    A short document of what gets built and what doesn’t, and how you’ll measure whether it works.

    ClaudeYou approve
  3. 03

    Skeleton

    The project’s structure, with tests and automatic checks from day one.

    Claude
  4. 04

    Tasks

    The work split into small stories, each with its “done when…”.

    Claude
  5. 05

    Build

    Story by story, with a team of agents that check each other.

    Claude
  6. 06

    Bug hunt

    It looks for bugs and security holes. Every kind of bug it finds leaves a check so it doesn’t come back.

    Claude
  7. 07

    Release

    First to a test copy. To your users, only when you approve it.

    ClaudeYou approve

You choose once how it works: stage by stage, stopping at each one for your review, or automatic, stopping only where a person is needed: questions only you can answer, accounts, money, production.

−6 m

Every story goes through a team, not a single agent.

Each role is a different agent with its own job, and none of them grades its own work.

verifier

The verifier

Before anyone writes code, it turns the story’s criteria into tests. At the end it uses the app the way your customer would. It’s the only one that can say “done”.

general agent

The builder

Writes code until the tests pass. It didn’t write them, and it doesn’t decide when it’s finished.

reviewer

The reviewer

Reads the code cold against the story and the house rules, like a colleague who didn’t write it.

breaker

The breaker

Tries to break it: two clicks in a row, two requests at once, a user from another account, the edge of every limit.

context-auditor

The auditor

Before anything is built, it reads the context and the PRD like an outsider: what’s missing, what contradicts itself.

The agent that writes the code can’t close a task until another agent has reviewed it.

−8 m

Where everything happens.

Keelokit has no server of its own and collects nothing. Everything stays on your computer and in your accounts.

Your computer

Where the work happens

Claude Code runs there with Keelokit. That’s where the code is written and the app is tried out while it’s built.

GitHub

Keeps it and checks it

  • Keeps the code in a private repository in your name, with the history of every change.
  • On every change, a robot runs all the tests and checks. If something fails, it doesn’t go in.
  • Asks a person to approve before anything reaches production.

Fly.io

Where the app lives

The server on the internet for the back of the app, the part that handles requests, and its database.

Environments and the other pieces, in detail

−10 m

New in 0.8

One page to work from, one report to share

/keelokit:project-dashboard builds a short page from your repo, in your language: where the project is, the next step, what waits for you. It stays live and light, so following a project costs very few tokens. /keelokit:project-report generates the complete status, read-only, to share.

Fleetly, a sample mobile app for delivery fleets, halfway through its buildOpen full size
One page to work from, one report to share: Fleetly, a sample mobile app for delivery fleets, halfway through its build

Every view, in light and dark

−12 m

New in 0.9

Your app on your phone, in one command

/keelokit:run-local starts the database and the API and opens your app on an Android phone, an emulator or the iOS simulator. It checks what your Mac is missing and installs it after one yes.

macOS for now. Launched on a Galaxy S20 over USB and on the iOS simulator.

The terminal, step by step

−14 m

The part you don’t see

In my experience, agents tend to close stories and leave a trail of bugs behind them, bugs they neither write down nor mention. That’s where these four ideas came from.

I

A rule needs a check

Each rule points to something that verifies it: a test, a lint rule, a git hook, a CI job.

II

Unknowns stay questions

What nobody knows yet is written down with an owner, not guessed.

III

The builder doesn’t grade itself

One agent writes the tests first, another reads the diff cold, another tries to break it.

IV

Bugs come in classes

Each bug that escapes leaves a check for its whole class, so it can’t come back.

The proof, the doctor and the rules

−16 m

Questions before you start.

Do I need to know how to code?

Not to use it. To install it, a little: you need Node, Python, Docker and git, on macOS or Linux, and you use it from the terminal. If you’ve never opened one, ask someone to help the first time. After that, Claude guides you.

How much does it cost?

Keelokit is free and open source. You pay for your Claude plan, which gets more use than a regular chat because several agents work on each story, and for hosting the app. Claude asks before creating anything paid.

Where does my data stay?

In your repository and your accounts. Keelokit has no server of its own and collects nothing.

What if I already have a project?

/keelokit:project-adopt adds the rules and the checks to your repo without rewriting your code. If your stack is different, you get the rules and the checks, but not the skeleton.

Where to start

What you haveStart withWhat you get
An idea, nothing else/keelokit:project-newA monorepo that runs, with CI, context and a first backlog
A repo you already have/keelokit:project-adoptThe rules mapped to its checks, and the rest as dated debt
A story to build/keelokit:build-storyTests written first, code that passes them, a verified result
A project to follow/keelokit:project-dashboardA light, live page: the next step to copy, what waits for you, every wave and its stories

All twelve commands

−17 m

Good to know

It’s opinionated

It’s built around my preferences and my stack. It won’t fit every project or every team. If your stack is different, /keelokit:project-adopt still gives you the rules and the checks.

It uses tokens

build-story and check-bugbash run several agents per story. /keelokit:build-story --light exists for small changes.

The guard is a speed bump

It stops agents from the obvious mistakes, but it isn’t a sandbox. Git hooks and CI are the real backstop.

The doctor sees presence, not quality

It can tell a check exists and is switched on, not that it’s a good check. For critical code, mutation testing measures that; elsewhere, reviews and bug hunts cover it.

−18 m

Try it

 claude plugin marketplace add leosimini/keelokit claude plugin install keelokit@keelokit

In an empty folder run /keelokit:project-new. In a repo you already have, /keelokit:project-adopt.

You need Node 22 with pnpm 10, Python 3.11+, uv, Docker and git. macOS or Linux.

Download .zipCode, docs and license on GitHub

The download is keelokit-plugin.zip, the plugin ready to install: in Claude, Customize → Plugins → Upload. Each version’s zip is on its GitHub release.

Orchestrating sessions that can’t see each other? Keelokit Harbor is the other plugin