Flanner | Version control for your AI's planning docs<br>Star on GitHub

MITopen source · v0.7.1 on PyPIStop drowning in AI .md files.<br>Flanner is a free, open-source CLI and MCP server for the planning docs your AI agents generate. Those files scatter in two directions at once, across your repos on disk and across the issues in your tracker, and flanner is the control point for both, versioning every revision and linking each plan to the issue it belongs to.<br>$pip install flanner<br>Get started on GitHubJoin the cloud waitlist<br>▹MITlicensed<br>▹100%local, no account<br>▹MCPClaude Code + Codex

architecture.mdSynced<br>historyv1v2v3<br>mcp_plan_file: true<br>version: 3<br>updated_by: claude<br># System Architecture<br>- Document the guard-hook flow<br>+- Wire AGENTS.md for Codex

Git-protected

// features<br>Everything you need to manage AI plan files<br>Built for AI-assisted development with Claude Code, Codex, and any MCP client

core<br>Agent Integration<br>A guard hook plus CLAUDE.md/AGENTS.md and a skill auto-route every plan through flanner, so you never remind the agent to save its docs.

core<br>MCP Integration<br>Seamlessly integrates with Claude Code, Codex (AGENTS.md), and other AI assistants through the Model Context Protocol

core<br>Git Protection<br>Automatically prevents plan files from being committed to git via .gitignore management

YAML Frontmatter<br>Every plan file includes metadata with project info, versioning, and ownership tracking

core<br>Automatic Versioning<br>Tracks changes with semantic versioning and maintains complete history of all plan iterations

Web Dashboard<br>Beautiful browser-based UI for viewing, editing, and managing plan files with markdown preview

CLI Tool<br>Powerful command-line interface for project management, syncing, and status checking

SQLite Storage<br>Everything lives in a local SQLite database on your machine, no account required. Cloud workspaces are on the roadmap.

Configurable<br>Customize plan directory per project and configure git integration preferences

// workflow<br>How flanner works<br>From init to a fully versioned plan history, in five steps

Initialize<br>Run 'flanner init' to set up the database, create .plans directory, and auto-register with Claude Code

Create Plans<br>Ask Claude to create plan files through MCP<br>or<br>Manually create and attach files to your local projects

Track Versions<br>Every update creates a new version with complete history and metadata preserved

Manage & View<br>Use the web UI or CLI to browse plans, view history, and manage your projects

Collaborate<br>Push files to your remote organisation account, and sync with JIRA to associate .md files to tasks

// use cases<br>Built for how developers actually work<br>Whether you're solo or on a team, flanner adapts to your workflow

Solo Developers<br>Keep your architecture decisions and planning organized with AI assistance from Claude

Development Teams<br>Share plan files, track who made changes, and maintain consistent documentation across the team

AI-First Workflows<br>Let Claude Code manage your planning documents while maintaining version control and audit trails

Project Documentation<br>Store RFCs, technical specs, and architecture decisions with automatic versioning

Open Source Projects<br>Manage project roadmaps and feature planning with git-ignored local plan files

Remote Teams<br>Asynchronous collaboration with web dashboard access and clear ownership tracking

// integrations<br>Keep plans tied to the work<br>Connect flanner to your issue tracker. Linear syncs live; more are on the way.

Linear<br>live status sync<br>Two-way sync over the Linear API. Plans update automatically as their linked issues move through your workflow.

Jira<br>supported · links<br>Link any plan to a Jira issue for traceability. Link-based today, without live status sync.

More coming

GitHub Issues, Notion, and more integrations are on the way.

Coming soon<br>Flanner Cloud<br>The local tool is free and open source today. Cloud workspaces (shared storage, team collaboration, and links to Jira, Notion, and chat) are on the roadmap. Join the waitlist to hear first.<br>Join waitlistLeave your email and you'll get exactly one message the day it ships. No spam.

Ready to Get Started?<br>Install Flanner, connect it to Claude Code or Codex, and start managing your plan files with confidence. Free and open source.<br>GitHub RepositoryView Installation Guide