Zbudowałem FlowState: żywy stan projektu dla Claude Code

Pracując z Claudem często nie wiemy, co realnie wykonuje, albo zapominamy, na co się umówiliśmy. Stan projektu żyje w plikach typu TODO.md i roadmapach, których nikt nie aktualizował na czas. Agent robi swoje, ja robię swoje, a prawda o tym, co jest zrobione, rozjeżdżała się z każdą godziną.

Dlatego zbudowałem FlowState. To żywy magazyn stanu projektu dla Claude Code, zamiast rozsypanych plików markdown. Jedno miejsce, w którym widać, co było, co jest teraz i co zostało do zrobienia.

Sedno jest takie, że agent i ja korzystamy z tej samej pamięci na żywo. Claude aktualizuje zadania przez MCP w trakcie pracy, a ja widzę to natychmiast na dashboardzie. Bez proszenia o podsumowanie, bez zgadywania, bez ręcznego przepisywania statusów.

Sercem jest Eksplorator: kaskada solucja → projekt → kamień milowy → zadanie, w której schodzisz od całego portfela aż do pojedynczego zadania z jego statusem i priorytetem. Pod spodem siedzi Next.js 16, node:sqlite i REST API, do tego serwer MCP z narzędziami fs_. Jest webowy dashboard i natywne aplikacje na macOS, obsługa wielu instancji oraz klucze API z uprawnieniami, więc kilku agentów może pracować obok siebie bez wchodzenia sobie w drogę.

Jest też warstwa grywalizacji, bo domykanie zadań powinno dawać frajdę. Liczniki zrobione dzisiaj, combo za serie, osiągnięcia i pełnoekranowa animacja, kiedy zamykasz cały projekt albo całą solucję. Do tego sporo drobnych, płynnych animacji w interfejsie, łącznie z efektem przelotu przez tunel, kiedy przełączasz się między instancjami serwera.

Dla mnie największa zmiana jest w głowie. Zamiast pilnować dokumentacji, mam jedno źródło prawdy wspólne dla człowieka i agenta. Mniej dryfu, mniej tarcia, więcej realnego flow w robocie.

Projekt jest otwarty, więc jeśli też pracujesz z Claude Code i męczą Cię pliki ze stanem, zajrzyj i pobaw się. Repo: github.com/NovaSeth/FlowState.

Working with Claude, we often don't know what it's actually doing, or we forget what we agreed on. The state of a project lives in files like TODO.md and roadmaps that nobody updated in time. The agent does its thing, I do mine, and the truth about what's actually done drifted further apart by the hour.

So I built FlowState. It's a live store of project state for Claude Code, instead of scattered markdown files. One place that shows what was done, what's happening now, and what's left to do.

The core idea is that the agent and I use the same memory, live. Claude updates tasks through MCP as it works, and I see it instantly on the dashboard. No asking for a summary, no guessing, no manually rewriting statuses.

The heart of it is the Explorer: a cascade of solution → project → milestone → task, where you drill down from the whole portfolio to a single task with its status and priority. Under the hood it runs on Next.js 16, node:sqlite and a REST API, plus an MCP server with fs_ tools. There's a web dashboard and native macOS apps, multi-instance support, and API keys with permissions, so several agents can work side by side without getting in each other's way.

There's also a gamification layer, because closing out tasks should feel good. Counters for what you finished today, combos for streaks, achievements, and a full-screen animation when you close an entire project or solution. On top of that, plenty of small, smooth interface animations, including a fly-through-the-tunnel effect when you switch between server instances.

For me the biggest change is in my head. Instead of policing documentation, I have one source of truth shared between human and agent. Less drift, less friction, more real flow in the work.

The project is open, so if you also work with Claude Code and state files wear you down, take a look and play with it. Repo: github.com/NovaSeth/FlowState.