How kenn-io/roborev works
roborev is a local, continuous code-review system for AI coding workflows. Its main loop begins when a commit triggers a background review; findings are stored and surfaced in the terminal or browser, then can be sent to an agent for fixes whose new commits are reviewed again. The daemon also serves analysis, verification, search, agent-session hooks, and optional cross-machine sync. The README documents these product flows; sampled source confirms key daemon routes, storage, and browser-session/API boundaries, but not every internal call.
Main entry points: server.go Daemon API · worker.go Review Worker · runner.go Review Pipeline · db.go Local Review Store
Components 20
Review Engine
- Post-commit Hook
internal/githook/githook.go - Review Worker
internal/daemon/worker.go - Agent Runners
internal/agent/agent.go - Review Pipeline
internal/review/runner.go - Review Prompts
internal/prompt/prompt.go - Code Analysis
internal/prompt/analyze/analyze.go - Finding Verification
internal/review/synthesis.go - Fix / Refine
cmd/roborev/fix.go
Local Daemon
- Daemon API
internal/daemon/server.go
User Interfaces
- Terminal UI
cmd/roborev/tui/handlers_msg.go - Browser UI
web/src/App.svelte - Browser API Client
web/src/lib/api/client.ts
Agent Automation
- Agent Session Hooks
internal/agenthook/install.go - Review Event Hooks
internal/daemon/hooks.go
Review Data
- Local Review Store
internal/storage/db.go - Remote Sync
internal/storage/syncworker.go - Review Search
internal/searchindex/service.go
Other components
- Developer / Git
- Configured Coding Agents
- Optional PostgreSQL
Connections 24
- Developer / Git → Post-commit Hook: commits code
README.md - Post-commit Hook → Daemon API: enqueues review
README.md - Daemon API → Review Worker: dispatches jobs
- Review Worker → Review Pipeline: runs review
- Review Pipeline → Review Prompts: builds prompts
- Review Pipeline → Agent Runners: invokes agent
- Review Worker → Local Review Store: persists findings
- Developer / Git → Code Analysis: requests analysis
README.md - Code Analysis → Daemon API: submits analysis job
- Developer / Git → Finding Verification: runs compact
README.md - Developer / Git → Fix / Refine: requests fixes
README.md - Fix / Refine → Configured Coding Agents: asks for changes
README.md - Developer / Git → Terminal UI: views reviews
README.md - Terminal UI → Daemon API: requests review data
- Developer / Git → Browser UI: browses reviews
README.md - Browser UI → Browser API Client: uses API client
web/src/App.svelte - Browser API Client → Daemon API: calls API
- Daemon API → Local Review Store: reads and writes
internal/daemon/server.go - Developer / Git → Review Search: searches history
README.md - Agent Session Hooks → Daemon API: posts session events
README.md - Daemon API → Review Event Hooks: runs configured hooks
- Configured Coding Agents → Agent Session Hooks: emits session events
README.md - Remote Sync → Local Review Store: syncs local records
internal/storage/syncworker.go - Remote Sync → Optional PostgreSQL: pushes and pulls
internal/storage/syncworker.go