SmritiFlow
A CLI that keeps repository memory current so coding agents can resume work with accurate project context.
Problem
Long-running code work loses decisions and current state between sessions. Rebuilding that context wastes time and encourages agents to act on stale assumptions.
System
A TypeScript monorepo scans repository structure and Git state, generates machine-readable memory artifacts, and writes concise agent-facing documents for scan, refresh, status, and resume workflows.
Proof
- Published with `smritiflow` and `sf` command aliases.
- Generates cache, project map, scan report, AGENTS.md, and focused handoff documents.
- Includes init, scan, refresh, status, and resume workflows.
- Covers parsers, generators, and end-to-end artifact generation with automated tests.
Architecture
- InitializeCreate the repository-memory contract and ignored artifacts.
- ScanInspect project structure, routes, imports, and Git context.
- GenerateWrite structured cache and concise agent-facing documents.
- ResumeReturn with current context, freshness signals, and next actions.
Decisions
- Generate both structured JSON and readable Markdown from the same scan.
- Expose freshness explicitly through status and refresh commands.
- Keep parsing, Git context, generation, and CLI orchestration independently testable.
Tradeoffs and limitations
- Generated summaries can become stale and must never replace direct source inspection.
- A CLI is efficient for developers but less approachable than a hosted interface.
Technologies
- TypeScript
- Node.js
- pnpm
- Vitest
- Commander
- Agent Skills