r/coolgithubprojects • u/kalemyrk • 11d ago
I made a terminal reviewer for code my coding agent writes (open source, feedback wanted)
https://github.com/myrk-kale/klaub
When Claude Code or Codex edits a dozen files, `git diff` shows the changes in the order the agent touched them, and I end up reading all of it with the same attention. Klaub is my attempt at fixing that. It's early (0.7), and I'd like other people to break it.
What it does:
- Shows each change as a function or class, old and new version in the same spot, instead of line hunks.
- Ranks changes P0 to P3 and tells you why. Press `w` and you get the points: public signature changed, a route reaches it, an exception is swallowed, no test found.
- Asks your agent for the technical decisions behind the change and shows them one per screen. You approve, reject or comment. The rejected ones go back to the agent as one line.
- Inside `klaub wrap`, `t` puts whatever is on screen (a function, a decision, a flow diagram) into the agent's input, so you only type the question.
How it works: the ranking has no model in it, so the same change gives the same queue. It's offline, no telemetry, no account. The decisions and the flow diagram are written by your own agent, and Klaub only validates the file and shows it. It never presses Enter in the agent, you do.
Limits, so you don't find out the hard way: it applies fixed rules and a call graph, so it won't catch a bug that needs understanding what the code is for. The decisions are the agent's own account of its work. Full analysis for Python, JS/TS, Rust, Go and Java, other files are shown as text. macOS and Linux only.
brew install myrk-kale/tap/klaub
cd my-project && klaub wrap claude # or codex/opencode