kaizen-cli 0.1.43

Distributable agent observability: real-time-tailable sessions, agile-style retros, and repo-level improvement (Cursor, Claude Code, Codex). SQLite, redact before any sync you enable.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133

# kaizen

Kaizen watches your coding agents work, locally, across Cursor, Claude Code,
Codex, OpenClaw, Goose, OpenCode, and Copilot.

At the end of the week, it tells you what's wasting tokens, causing loops,
or making agents worse in this repo.

Then it lets you test the fix: "add this rule", "split this file", or
"delete this unused skill" becomes measurable instead of vibes.

[![crates.io](https://img.shields.io/crates/v/kaizen-cli.svg)](https://crates.io/crates/kaizen-cli)
[![CI](https://github.com/marquesds/kaizen/actions/workflows/ci.yml/badge.svg)](https://github.com/marquesds/kaizen/actions/workflows/ci.yml)
[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](LICENSE)
[![Sponsor](https://img.shields.io/badge/Sponsor-FF5E5B?logo=ko-fi&logoColor=white)](https://ko-fi.com/lucasmarques)

## Demo

https://github.com/user-attachments/assets/64e2739a-6102-4abb-9ce7-9d4046dd56ca


## Install

You need **Rust 1.95+** from [rustup](https://rustup.rs).

```bash
cargo install kaizen-cli --locked
```

The command installs the `kaizen` binary into `~/.cargo/bin` or
`$CARGO_HOME/bin`. If your shell cannot find it, add that directory to
`PATH` and open a new terminal.

Developing Kaizen itself? Use `./scripts/install-local.sh` from a clone,
or `cargo install --path . --locked`. Detailed install notes live in
[docs/install.md](docs/install.md).

## Quick Start

```bash
cargo install kaizen-cli --locked
cd my-repo
kaizen init
kaizen open
# use your coding agent for a day...
kaizen summary
kaizen retro
```

`kaizen init` creates local storage under
`~/.kaizen/projects/<slug>/` and wires supported agent hooks idempotently.
Re-running it is safe; originals back up under the project data directory.
Kaizen-owned writes never touch the target repository. Hook configuration lives
in your user home, and legacy `<repo>/.kaizen/` data is copied rather than moved.

## How the Loop Works

**Observe.** Kaizen tails agent transcripts and hook events into one local
SQLite database per workspace. It can watch Cursor, Claude Code, Codex, OpenClaw,
Goose, OpenCode, and Copilot without running the model itself.

**Understand.** `kaizen open`, `kaizen summary`, and `kaizen metrics` turn
sessions into a local dashboard, cost rollups, tool timing, and repo facts.
The metrics pass indexes file-level and graph facts so retros can talk about
this codebase, not only token totals.

**Propose.** `kaizen retro` runs deterministic heuristics and groups bets by
confidence and action type: one high-confidence bet, up to two investigations,
and up to two quick hygiene fixes.

**Measure.** `kaizen exp new` can bind a change to git history and compare
control vs treatment sessions with bootstrap confidence intervals.

Nothing leaves disk unless you configure sync or a provider query. Team paths
redact secrets, env vars, absolute paths, and git emails before upload.

## Why Kaizen

| You want... | Existing tool | Kaizen |
|---|---|---|
| Cost per session for Claude Code | `ccusage`, `claude-usage-report` | Yes, plus Cursor, Codex, OpenClaw, and hook provenance |
| Cost per session for Cursor | Manual transcript work | Best-effort token and model recovery from transcript tails |
| One local view across agents | Glue scripts | Unified store, one CLI, one MCP surface |
| Repo-aware improvement bets | Dashboards only | Weekly retro with evidence, confidence, and apply steps |
| Local-first data | Hosted account | SQLite-only local store; sync is opt-in and redacted |
| Measure whether a fix worked | Spreadsheets | Git-bound A/B experiments and bootstrap reports |

Kaizen is a local feedback loop with a dashboard, TUI, and CLI:
**capture → understand → improve → measure**.

## Advanced Features

- **HTTP proxy:** `kaizen proxy run` logs Anthropic API calls with precise
  token counts and optional context policy trimming.
- **Provider queries:** PostHog and Datadog rollups can be read with
  `--source provider` or merged with local rows via `--source mixed` when
  `[telemetry.query]` is configured.
- **Redacted sync:** shared endpoints receive batches only after local
  redaction and UUIDv7 deduplication.
- **A/B experiments:** `kaizen exp new --bind git` classifies later sessions
  by commit boundary and reports treatment deltas.
- **MCP tools:** most read/report commands are exposed to agents; shell-only
  commands stay in the CLI.
- **Local depth:** optional test/lint snapshots and CPU/RSS samples improve
  retro signals without shipping raw command output off disk.

## Docs

| Doc | Purpose |
|---|---|
| [docs/install.md](docs/install.md) | Install, build from source, uninstall |
| [docs/tutorial/README.md](docs/tutorial/README.md) | Hands-on tutorial |
| [docs/usage.md](docs/usage.md) | CLI reference index |
| [docs/web.md](docs/web.md) | Local Web dashboard |
| [docs/tui.md](docs/tui.md) | Terminal UI controls |
| [docs/concepts.md](docs/concepts.md) | Sessions, events, retro, experiments |
| [docs/retro.md](docs/retro.md) | Heuristic retro engine |
| [docs/experiments.md](docs/experiments.md) | A/B experiment workflow |
| [docs/architecture.md](docs/architecture.md) | Module graph, data flow |
| [docs/config.md](docs/config.md) | Config file and env vars |
| [docs/telemetry-journey.md](docs/telemetry-journey.md) | How sessions become stored facts |
| [CONTRIBUTING.md](CONTRIBUTING.md) | Dev setup, tests, PR flow |
| [CHANGELOG.md](CHANGELOG.md) | Release notes |

## Status

Pre-1.0: breaking changes may appear in minor versions. Follow
[CHANGELOG.md](CHANGELOG.md) for release notes.

## License

[AGPL-3.0-or-later](LICENSE). Contributions are licensed under the same
terms. Security disclosures: [SECURITY.md](SECURITY.md).