retro Project Wiki
retro Project Wiki
retro captures Codex, Claude Code and VS Code Copilot Chat agent sessions, normalizes them into durable local artifacts, scores them with signals, mines reusable memory, turns trajectories into frozen benchmark tasks and experiments, and builds a static dashboard.
This site is the onboarding hub for users and contributors.
Start Here
- Onboarding: install, import your first sessions, run signals, mine memory, and build the dashboard.
- Guides: common workflows for capture, mining, retrieval, and troubleshooting.
- CLI reference: command groups and examples.
- Architecture: pipeline layers and source-of-truth rules.
- Memory backend: SQLite index, FTS retrieval, wiki-links, utility updates, and weave.
- Dashboard: static HTML dashboard and cost modes.
- Contributing: development setup, tests, lint, and plugin patterns.
- Roadmap: implemented work and remaining phases.
Current Shape
raw/ -> normalized/ -> signals/ -> mined/ -> memories/ -> dashboard/
Each stage reads from disk and can be re-run independently. Flat files remain canonical; SQLite and dashboard data are derived rebuildable artifacts.
Dashboard Preview
Source Documents
The detailed design specs remain in the repository: