kaziGitHub
OPEN SOURCE. OBJECTIVE OUTCOMES.
Apache-2.0 · v2.0.1

Done meansverified.

Your coding agent has the ability.
Kazi gives it a finish line.

A continuous loop that turns your goals into checked results.
It keeps your agent working until every check passes, or tells you what’s blocking it.

✓Checks decideObjective completion
↻Work continuesObserve. Fix. Verify.
⊣Limits holdExplicit run budgets
{ }Code is openApache-2.0 licensed
A CONTROLLER FOR CODING AGENTSExplore Kazi
01 / THE LOOP

A goal.
A loop.
A real result.

Your coding agent says "done." kazi proves it.

Kazi is the outer/reconciliation loop for coding agents. Think of it as Kubernetes for coding goals: declare the desired outcome, then close the gap.

You describe the outcome. Your agent drafts the acceptance checks. Kazi observes what is failing, sends the work back to the agent, and checks again.

Tests, exact file contents, a live endpoint: you choose what completion means. Kazi reports success only when every declared check passes.

Read the engineering behind it ↗
01

Define done

Set the goal, its acceptance checks, the allowed scope, and a budget.

02

Close the gap

Failing checks become the agent’s next assignment. Kazi rechecks after the work.

03

Know the outcome

Converged, stuck, or over budget. Every stop has a reason you can act on.

02 / EVIDENCE, INCLUDED

Less “trust me.”
More show me.

One failing Go test. A real agent run.
A result verified by the controller.

● ● ●kazi apply · recorded runReproduce ↗
Recorded Kazi run: the tests-pass check fails on iteration one, passes on iteration two, and the controller reports CONVERGED.
Actual recorded output from the Kazi repository. View the original recording ↗
A RECORDED EXAMPLE · v1.64.2

Existing isn’t the same as exact.

The goal required VERSION.txt to contain exactly 1.0.0. Kazi checked the bytes and drove the run to convergence in 2 iterations.

2

iterations to verified completion
One recorded run, not a performance guarantee.

Inspect the method and evidence ↗
Explore the full proof gallery ↗
03 / BUILT FOR REAL WORK

More autonomy.
Keep the control.

[✓]

Your checks hold the line.

Completion belongs to the controller. Stored evidence makes each result inspectable. The strength of that result depends on the checks you define.

↗↗

Parallel work, coordinated.

Resource leases coordinate overlapping edits. A session bus lets agents exchange updates, while the dashboard makes fleet progress visible.

⌘

Keep your coding agent.

Start with Claude Code. Kazi also supports other CLI harnesses, including Codex and opencode, with documented support tiers.

Compare harness support ↗
⊣

Know when to step in.

Iteration, time, and token budgets bound the run. Repeated failures surface as stuck, so the next decision returns to you.

~

Spend reasoning deliberately.

Use a stronger model to define the work, then a cheaper one for iterations. Let the orchestrating skill escalate difficult slices. Savings are an intended benefit, not a measured promise.

⌂

Choose where models run.

Connect opencode to a local model when your workflow calls for local inference. Data handling still depends on the model, tools, and services you configure.

04 / YOUR NEXT FINISHED THING

Stay in your chat.
Give it a loop.

Install Kazi once. Add its skill to Claude Code.
Then describe the outcome you want to ship.

Requires Homebrew and a configured Claude Code installation. The Kazi binary includes its runtime.

Other platforms and source builds ↗
01

Install the controller + skill

brew install kazi-org/tap/kazi
kazi install-skill
02

In Claude Code, define the goal

/kazi plan "add a /healthz endpoint
that returns 200 ok, with a test,
deployed"
03

Review the checks. Start the loop.

/kazi apply

Prefer plain English? Say have kazi drive this until done in Claude Code after installing the skill.

The skill installs locally. Kazi drives your coding agent; it does not bundle one.

05 / BEFORE YOU RUN

Good questions.
Straight answers.

Is Kazi another coding agent?

Kazi is a reconciliation controller around the coding agent you already use. The agent edits code. Kazi evaluates the checks and decides whether more work is needed.

Does a passing run mean my software is perfect?

A passing run means all declared acceptance checks passed. Missing or weak checks leave gaps. Review the proposed checks before applying a goal, and include the deployed behavior when that matters.

What happens when the agent cannot finish?

Kazi can stop as stuck when failures repeat, or over budget when a run reaches its configured limits. You can inspect the evidence, refine the goal, or change the approach.

Is it free to use?

Kazi is open source under Apache-2.0. Your coding agent, model provider, and infrastructure may have their own costs. Read the license.

Can it check a deployed service?

Yes. Acceptance predicates can probe a live endpoint. Deployment requires your own configured commands, tools, and access. Include the live check in the goal when production behavior defines done.

Where do I report bugs or contribute?

Use GitHub Issues for bugs and Discussions for questions. The repository includes setup instructions, architecture decisions, and reproducible examples.

06 / MEET THE MAKER
DAVID NDUNGU / ENGINEER & FOUNDER

I build the tools.
And the systems
that depend on them.

Useful AI needs dependable engineering.

I created Kazi to make completion something a system can verify. It reflects the way I approach automation: clear outcomes, explicit checks, and a reason for every stop.

Through my consultancy, I build custom AI automations for business workflows, connected to real tools with human approval gates. Kazi is one piece of that engineering, open for you to inspect.

Work with David Explore my open-source work ↗