retro Project Wiki
retro Project Wiki
retro captures Codex and Claude Code agent sessions, normalizes them into durable local artifacts, scores them with signals, mines reusable memory, 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: