kaizen-agent weekly downloads statistics

<div align="center"> <img src="https://raw.githubusercontent.com/hfadhlullah/kaizen/main/assets/banner.png" alt="kaizen" width="760"> </div> <p align="center"><b>One tool to build and maintain your product with AI agents.</b><br>Requests in, a plan you approve, the work, an independent review, done.</p> <p align="center"><img src="assets/hero.gif" alt="Animated walkthrough of the real kaizen board with sample data. 1: a request gathered from a support sheet waits in the Icebox and is promoted. 2: it is an idea on the board, and Run opens Claude Code. 3: the agent works in the card's own terminal and writes a plan. 4: the plan panel shows what done and wrong mean, and it is approved. 5: it builds, then a reviewer that never saw the work reports a high finding, a double charge. 6: only that finding is ticked and fixed. 7: the reviewer re-checks it. 8: the run lands in Done, with the low finding left in the backlog." width="760"></p>

The problem

You ask an AI coding agent to retry a payment webhook when the bank times out. It starts editing at once, then says "Done, tests pass." The tests do pass. They were written by the same agent, from the same assumption: that a timeout means the charge failed. Sometimes the bank said yes and the reply got lost. Now a retry charges the customer twice, and nothing in the agent's report would make you look.

None of this is a lack of intelligence. It is a missing workflow:

What goes wrong	What kaizen does
The agent decides what "done" means on its own, and you find out from the diff	It writes a plan first, including what wrong would look like, and waits for your approve or change
The author grades its own work, so its blind spot is in the code and in the check	A second agent that never saw the work reviews it, from the request, the plan and the diff only
Findings get fixed in an endless loop, or silently dropped	Serious findings are fixed and re-checked, at most twice; the rest come to you, and what is left goes to a backlog
Requests live in sheets, docs and social posts; the plan in one chat, the review in another, the commit somewhere else	One board, from an icebox that gathers those requests to an idea, a plan, the build, the review, the fix loop and the commit, every step on file

Many assistants now ask for approval before they act, and some run a checker on their own draft. The difference here is who checks: a reviewer that shares the author's context shares its blind spots. Kaizen's reviewer starts cold, on purpose.

Every stage is a file in .kaizen/runs/<id>/, so a run can be resumed later, by another session or another tool (Claude Code, Codex, Antigravity), and read back when someone asks why the code is the way it is.

Who it is for

Good fit if you:

• Build and maintain a product, and want one place for it: requests gathered from where they live, then plan, build, review and commit, without switching tools.
• Already use an AI coding agent, and have caught it confidently wrong more than once.
• Change things where a mistake is expensive: money, data, migrations, anything a customer sees.
• Want to see and steer the plan before code is written, not reverse-engineer it from a diff.

Not for you if:

• Your changes are typos and one-liners. A run costs several times one prompt; kaizen takes a short path for small work, but it is not free.
• You want the agent to ship without you. Kaizen is built to stop and ask.
• You do not use an AI coding agent. Kaizen runs inside one; it is not one.

Install

macOS and Linux

curl -fsSL https://bun.sh/install | bash && ~/.bun/bin/bunx kaizen-agent

Already have Bun? Run bunx kaizen-agent.

kaizen needs an AI coding agent such as Claude Code. If none is installed, the installer lets you pick one, runs its official installer after you say yes, and then carries on. Git is needed for the board's commit and push.

Windows

Windows support is still in beta. In PowerShell:

irm bun.sh/install.ps1 | iex; & "$env:USERPROFILE\.bun\bin\bunx.exe" kaizen-agent

Already have Bun? Run bunx kaizen-agent. As on macOS and Linux, the installer offers to install an AI coding agent when none is found; Git is only needed for the board's commit and push.

Use the board

kaizen web

<img src="https://raw.githubusercontent.com/hfadhlullah/kaizen/main/assets/board-v2.png" alt="kaizen board" width="760">

The board opens in your browser. The side menu holds the board, notes, the icebox of gathered requests and settings, with a light and dark switch. From there you can start a run, approve or revise its plan, pick which review findings to fix, then commit and push.

Right after installing, kaizen setup walks you through your project, settings, this board and the phone app (it prints a QR code to scan).

Phone app

The board is a PWA: installed from the browser, it opens full screen with the kaizen icon. It needs Tailscale on this PC and on your phone, both signed in to the same account.

kaizen setup        # guided: starts the board, runs tailscale serve, prints a QR code

Scan the QR code with your phone camera, then Add to Home screen (iOS: Share menu; Android: browser menu, Install app).

By hand: run kaizen web, then tailscale serve --bg 127.0.0.1:7420, add <pc>.<tailnet>.ts.net to ~/.kaizen/web-hosts, and open https://<pc>.<tailnet>.ts.net on the phone. Details in docs/guide.md. Never use tailscale funnel — it publishes the board to the internet.

To add a launcher (Spotlight on macOS, the app menu on Linux, a Desktop shortcut on Windows), run kaizen web --shortcut once.

Development…