MITopen source · v0.7.1 on PyPI files.
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.
pip install flanner
- MIT
- licensed
- 100%
- local, no account
- MCP
- Claude Code + Codex
Everything you need to manage AI plan files #
Built for AI-assisted development with Claude Code, Codex, and any MCP client
Agent Integration
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.
MCP Integration
Seamlessly integrates with Claude Code, Codex (AGENTS.md), and other AI assistants through the Model Context Protocol
Git Protection
Automatically prevents plan files from being committed to git via .gitignore management
YAML Frontmatter
Every plan file includes metadata with project info, versioning, and ownership tracking
Automatic Versioning
Tracks changes with semantic versioning and maintains complete history of all plan iterations
Web Dashboard
Beautiful browser-based UI for viewing, editing, and managing plan files with markdown preview
CLI Tool
Powerful command-line interface for project management, syncing, and status checking
SQLite Storage
Everything lives in a local SQLite database on your machine, no account required. Cloud workspaces are on the roadmap.
Configurable
Customize plan directory per project and configure git integration preferences
How flanner works #
From init to a fully versioned plan history, in five steps
Initialize
Run 'flanner init' to set up the database, create .plans directory, and auto-register with Claude Code
Create Plans
Ask Claude to create plan files through MCP or Manually create and attach files to your local projects
Track Versions
Every update creates a new version with complete history and metadata preserved
Manage & View
Use the web UI or CLI to browse plans, view history, and manage your projects
Collaborate
Push files to your remote organisation account, and sync with JIRA to associate .md files to tasks
Built for how developers actually work #
Whether you're solo or on a team, flanner adapts to your workflow
Solo Developers
Keep your architecture decisions and planning organized with AI assistance from Claude
Development Teams
Share plan files, track who made changes, and maintain consistent documentation across the team
AI-First Workflows
Let Claude Code manage your planning documents while maintaining version control and audit trails
Project Documentation
Store RFCs, technical specs, and architecture decisions with automatic versioning
Open Source Projects
Manage project roadmaps and feature planning with git-ignored local plan files
Remote Teams
Asynchronous collaboration with web dashboard access and clear ownership tracking
Keep plans tied to the work #
Connect flanner to your issue tracker. Linear syncs live; more are on the way.
Linear
live status syncTwo-way sync over the Linear API. Plans update automatically as their linked issues move through your workflow.
Jira
supported · linksLink 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.
Flanner Cloud #
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.
Leave your email and you'll get exactly one message the day it ships. No spam.