Abe Burnett. Open source
FLOWSTATE MIT · OPEN SOURCE v2.9.0 · STABLE OPEN-SOURCED AUG 14, 2026

Memory that
spans sessions.

A free, open-source framework that gives your AI coding assistant persistent memory across sessions and across tools. One .flowstate/ directory of plain markdown files — no database, no infrastructure, no lock-in. Works with Claude, Cursor, Copilot, Windsurf, JetBrains, and anything else that reads instructions.

View on GitHub — MIT → Read the book that teaches the ideas →
MIT
LICENSE — USE IT, FORK IT, SHIP IT, TEACH IT
v2.9.0
STABLE · FEATURE-COMPLETE · FULLY DOCUMENTED
100% MD
EVERY BYTE IS PLAIN MARKDOWN — READ YOUR AI'S MEMORY LIKE A DIARY
6+ TOOLS
CLAUDE · CURSOR · COPILOT · WINDSURF · JETBRAINS · ANYTHING THAT READS FILES
What it isThree properties · one directory

The problem it kills

Every new session, your AI forgets the project: the decisions, the conventions, the architecture, what it was doing when you closed the laptop. So you re-explain everything, every time — or worse, you don't, and it quietly contradicts last week's choices. FlowState ends that.

01 · CONTINUITY

Session continuity

Resume session and your AI picks up exactly where it left off — decisions, tasks, conventions, architecture. Yesterday's context, today's conversation.

02 · PORTABILITY

Cross-tool

One .flowstate/ directory, adapters for every major AI tool. Hand off from Claude Code to Cursor mid-project without losing the thread.

03 · LEGIBILITY

Human-readable

Every byte is plain markdown. No database, nothing hidden, nothing to export. You can read your AI's memory like a diary — and edit it with a text editor.

StatusSaid plainly, on purpose

Stable — and in maintenance mode

PROJECT STATUS AS OF AUG 2026 MAINTENANCE MODE — ISSUES WELCOME, NO ROADMAP

Feature-complete, documented, and free. FlowState does what it sets out to do, and the 2.9 series is stable. Use it, fork it, learn from it.

Issues are welcome; a fast-moving roadmap is not. This is a deliberate posture, not abandonment: the framework's value is that it doesn't churn under you. If FlowState saves you one context dump, it has done its job — and if it saves you a hundred, the GitHub stars will find their way there on their own.

Insidev2.9.0 · the inventory

What's in the box

  1. 01The 20 Meta-Rules that govern AI behavior across every tool
  2. 02Immutable history — task log, decision log, session log, concept log
  3. 03CCT v2.0 learning protocol — teach conventions once, applied forever
  4. 04Quality modes — Fast / Balanced / Methodical, per task
  5. 05Multi-tool lock files for concurrent agents in one project
  6. 06Full docs — QUICKSTART, REFERENCE, TEMPLATES, TROUBLESHOOTING, UPGRADE, CHANGELOG
The storyPaid product → book backbone → public good

Why it's free now

FlowState grew out of a practical frustration: re-explaining a project to an AI every single session. It became a paid framework. Then it became the backbone of a book's professional-stack chapter — the context system that makes AI-built software hold up. And now, because the ideas matter more than the product, it's free for everyone.

The book that teaches the thinking behind it — including how to build your own context system from scratch, with or without FlowState — is Vibe Coding for Fun and Profit. The framework is the tool; the book is the understanding.

"The ideas matter more than the product."
— the whole reason for the license

LICENSE MIT © 2026 ABEBURNETT REPO GITHUB.COM/ABEBURNETT/FLOWSTATE USE IT · FORK IT · SHIP IT · TEACH IT