Repository navigation
FlowState 2.5.0 publishes the free server as flowstatemcp on PyPI and nudges agents to log as they go.
Install
uvx flowstatemcpOr: pipx run flowstatemcp. After pip install flowstatemcp, the flowstatemcp and flowstate commands both start the stdio server.
Added
- The free server is the PyPI package
flowstatemcp. The import name staysflowstate. A GitHub release publishes the sdist and wheel with PyPI Trusted Publishing. - The next brief reminds an agent that logged nothing. If the previous session on a project read FlowState and saved no record, the next
start_hereadds one line telling the agent to log decisions and changes as it works. - Copy-paste rules and one-click install. README and AGENTS.md have a three-line rule for CLAUDE.md, AGENTS.md, Cursor, Windsurf, VS Code Copilot, Claude Projects, and ChatGPT, plus Add to Cursor and Add to VS Code links for
uvx flowstatemcp.
Changed
- Agents are told when to write, not only what to write.
log_work, and the todo, problem, and handoff tools, say to record a decision, change, fix, or lesson right after it happens, and again before the session ends. The FlowState skill is now version 2.6.
Updating
- From 2.4.4 or later: quit your AI apps and run
flowstate updatein your own terminal, then reopen them. Or switch touvx flowstatemcp. - From 2.4.3 or older: follow "Updating" in the README.
Full details: CHANGELOG