Back to Home

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 init

Usage

Flow operates alongside your normal git workflow.

Start a Session

Begin tracking a coding session in your current git repository.

flow start

Stop 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 stop

Wake

Get a situational briefing on what you were last working on in this project.

flow wake