Documentation
Flow is a CLI that watches your coding session and tells you where you left off. Reclaim your context and reach flow state instantly. It tracks your AI tool chat logs (Claude Code, Cursor, Codex) and git activity, distilling it into concise project context using an LLM and Mem0.
Installation
Install the package from the project root:
git clone https://github.com/samrathp29/flow.git
cd flow
pip install -e .Setup
Run the initialization command to configure your LLM provider and API key. This interactive prompt will set up your provider (Anthropic or OpenAI), default models, and initialize the local storage directory.
flow initUsage
Flow operates alongside your normal git workflow.
Start a Session
Begin tracking a coding session in your current git repository.
flow startStop a Session
End the current session. Flow collates logs from Claude Code, Cursor, and Codex, summarizes git diffs with an LLM, redacts secrets, and stores the result as chunked messages in local vector memory via Mem0.
flow stopWake
Get a situational briefing on what you were last working on in this project.
flow wake