HN 표시: AI 대화 전반에 걸쳐 지속되는 FlowState Dev 메모리(MCP+SQLite)

Development memory that flows between sessions. FlowState is an open-source development memory system that helps developers maintain context across coding sessions. It tracks your projects, problems, solutions, and learnings so you never lose your train of thought — even when switching between projects or picking up work days later. FlowState works as an MCP server that integrates directly with Claude Desktop, giving Claude persistent memory about your projects. It also includes an optional desktop GUI built with Tauri + React for visual project management. - Project tracking — organize work into projects, components, and todos - Problem/solution logging — track bugs, attempted fixes, and what actually worked - Learnings capture — save insights, gotchas, and best practices as you discover them - Session continuity — Claude picks up exactly where you left off - Git sync — sync your development memory across machines - File attachments — attach relevant files to projects and problems - Search — find anything across all your projects - Desktop GUI — visual dashboard, kanban board, timeline, and more (optional) FlowState runs as an MCP (Model Context Protocol) server. When connected to Claude Desktop, Claude can read and write to your local FlowState database. This means Claude remembers your projects, what you were working on, what problems you've solved, and lessons learned — across every conversation. Your data is stored locally in a SQLite database on your machine. Nothing is sent to any external service. This is the fastest way to get FlowState working with Claude Desktop. No GUI needed. - Python 3.11+ - Claude Desktop pip package manager git clone https://github.com/dialectforge/FlowState.git cd FlowState cd mcp-server pip install -r requirements.txt Open your Claude Desktop config file: - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json Add FlowState to your mcpServers : { "mcpServers": { "flowstate": { "command": "python3", "args": ["-m", "flowstate.server"], "env": { "PYTHONPATH": "/path/to/FlowState/mcp-server" } } } } Replace /path/to/FlowState/mcp-server with the actual path to where you cloned the repo. After restarting, Claude will have access to FlowState's 21 tools. Try asking Claude: "Create a new FlowState project called 'My App' and describe it as a todo list application." FlowState provides 21 consolidated tools (reduced from 79 in earlier versions): | Tool | Description | |---|---| list_projects | List all projects | create_project | Create a new project | update_project | Update project details | get_context | Get full project context (the core tool — gives Claude everything it needs) | create_component | Add a component to a project | list_components | List project components | update_component | Update a component | log_learning | Capture an insight or lesson learned | get_learnings | Retrieve learnings | log_change | Record a change to a component | get_recent_changes | See what changed recently | search | Search across all content | problem | Log, list, solve, or view problem trees | attempt | Log solution attempts and their outcomes | todo | Add, update, or list todos | session | Manage work sessions and conversations | file | Attach, list, remove, or search files | git | Init, status, sync, set remote, clone, history | variable | Store project variables (servers, config, endpoints) | method | Document project methods (auth flows, deployment steps) | self_improve | Claude's skill learning and session state | The most important tool is get_context . At the start of any conversation about a project, Claude calls this to load everything it needs — components, open problems, recent changes, todos, and learnings. This is what gives Claude "memory" between sessions. FlowState can sync your database between machines using Git. - Create a private GitHub repo (e.g., flowstate-data ) - Initialize and connect: # Through Claude — just ask: "Initialize FlowState git and set the remote to [email protected]:username/flowstate-data.git" Or use the MCP tools directly: git init → git set_remote → git sync - On your other machine, clone the repo to the FlowState data directory: - macOS: ~/Library/Application Support/flowstate/ - Windows: %LOCALAPPDATA%/flowstate/ - Linux: ~/.local/share/flowstate/ - macOS: Ask Claude to run git sync at any time, or call it through the MCP tool. It commits changes, pulls from remote (with rebase), and pushes. FlowState includes a Tauri + React desktop app with visual views for managing your projects. - Dashboard — project overview with stats - Tree View — hierarchical component explorer - Kanban Board — drag-and-drop task management - Timeline — chronological change history - Search Panel — full-text search across everything - Decision Tree — problem/solution visualization - Story Mode — narrative view of your project journey - Architecture Diagr