Skip to content

Marco Rotili - Handgemacht.ai

Spotter tries to tackle problems that arise when you work with agent orchestrators on multiple projects at the same time: 1.

Core trick

Attaches reviewer comments to agent transcripts and exposes them to Claude Code through an MCP server for follow-up edits.

Tags

Description

Spotter tries to tackle problems that arise when you work with agent orchestrators on multiple projects at the same time: 1. You forget details about the product. Exact requirements, architecture 2. There is too much code to review Quality decreases over time. Spotter provides you with tooling to help you mitigate this with two novel approaches. First, it moves review left. Instead of reviewing the output of the agent, spotter allows you to attach comments to the agent and subagent transcripts. Using a MCP server, Claude Code can then address those comments and turn them into improvements for Claude Code or follow up issues for product fixes. Second, to help you remember important facts about the product and transcripts, it implements a spaced repetition system that surfaces information over time. Opus is used to extract the relevant information out of transcripts and commits. Together, they build a lens into the inner workings of Claude Code, and into your product.
marot/spotter★ 01 forksElixirMITCreated Feb 10, 2026 · last push Mar 13, 2026

README excerpt

# Spotter

Spotter reviews Claude Code sessions and generated code. It links Claude sessions to Git commits using deterministic hook capture plus asynchronous enrichment so each session can be traced to concrete repository changes. The runtime stack is Phoenix/LiveView for the app, xterm.js for terminal rendering, and tmux-integrated hook scripts for session event capture.

## Navigation

| Route | Page | Purpose |
|-------|------|---------|
| `/` | Dashboard | Ongoing sessions across all projects |
| `/sessions` | Sessions | Project-filtered session browsing with import, hide/unhide, and pagination |
| `/sessions/:id` | Session detail | Transcript review for a single session |
| `/reviews` | Reviews | Open review annotations |
| `/retros` | Retros | Session retrospectives |
| `/history` | History | Commit history and detail views |
| `/file-metrics` | File metrics | Heatmap and co-change analysis |
| `/telemetry/commands` | Telemetry | Shell command telemetry |

The sidebar highlights the active page. The Sessions link covers both `/sessions` and `/sessions/:id`.

## Local Development Runtime

**Scope:** local-dev only. No installer or production deployment support in this contract.

### Required Tools

| Tool | Purpose |
|------|---------|
| [just](https://github.com/casey/just) | Command runner (delegates to `scripts/runtime/`) |
| [overmind](https://github.com/DarthSim/overmind) | Process manager (reads `Procfile`) |
| [docker](https://docs.docker.com/get-docker/) | Runs 

Team