Docs / CLI reference
CLI reference
Every command, grouped the way flanner --help groups them.
Grouped the way flanner --help groups them. Commands above the team section work without an account or a network connection.
Core
flanner initAdopt the repository you are in: creates the store and registers the MCP server with every agent it finds
flanner init --setup codexRegister with one agent instead of all of them. Repeatable; the choices are the rows flanner status reports
flanner init --syncAlso import the plan files already in the repository. What you want when adopting one somebody else set up
flanner init --skip-claudeRegister with no agent at all
flanner statusCheck server status and project information
flanner doctorCheck the catalog against the plan files on disk
flanner listList all projects
flanner list --project PROJECT_NAMEList plan files for a specific project
Plans
flanner syncSync existing plan files into database
flanner sync --dry-runPreview sync without making changes
flanner sync --project PROJECT_NAMESync specific project only
flanner history PLAN_NAMEEvery version of a plan, newest first
flanner diff PLAN_NAME 2 3What changed between two versions
Freshness
flanner freshnessFreshness status for every plan, with the evidence behind it
flanner freshness PLAN_NAMEStatus and evidence for one plan
flanner why PLAN_NAMEWhy a plan is judged fresh, aging, suspect or stale
Web interface
flanner webLaunch web UI on default port (8080)
flanner web --open-browserLaunch and auto-open browser
flanner web --port 3000Launch on custom port
MCP server
flanner startRun the MCP server in the background on 127.0.0.1, for clients that speak http
flanner stopStop the MCP server
Agent integration
flanner claude-infoShow integration status
flanner setupRe-run the agent registration on its own. flanner init already does this; use it to repair one
flanner registerRegister MCP server with Claude Code
flanner register --forceForce update configuration
flanner unregisterUnregister from Claude Code
Memory
flanner mem remember "..."Save one durable fact, as a Markdown file you can read
flanner mem recall "..."Search what earlier sessions knew, with why each result matched
flanner mem listBrowse memories rather than searching them
flanner mem show IDOne memory in full, with everything that happened to it
flanner mem supersede ID "..."Correct a memory by replacing it, keeping the old one readable
flanner mem forget IDStop recalling a memory, or erase it from this machine
flanner mem mode suggestHow much this project captures: off, explicit, suggest or auto-safe
flanner mem pendingSuggestions waiting on you, with approve and reject
flanner mem attach ID FILEAttach a screenshot, PDF or recording as evidence
flanner mem share IDShare one memory with the team. Always explicit
flanner mem withdraw IDAsk peers to stop recalling one you shared
Your team
flanner accept TOKEN --as your-handleAccept an invitation: joins the team and enrols this machine. Once per machine
flanner login CODEEnrol this machine with an enrollment code from the team console
flanner whoamiThis device's identity, what its entitlement allows, and which workspaces you may enter
flanner logoutForget this device's session. The device keeps its identity
flanner join WORKSPACE_IDBind this repository to a workspace. Run with no id to list the ones you may use
flanner invite someone@company.comInvite somebody to your organization (admins only)
flanner membersYour organization's members and seat count (admins only)
flanner devicesThe machines enrolled under your account
Syncing with other machines
flanner peer serveServe this device's catalog to authorised peers. Opens no port and needs no admin rights
flanner peer start / flanner peer stopThe same thing in the background, so it keeps serving after you close the terminal
flanner peer pull DEVICE_IDTake whatever a peer holds that this device lacks. Syncing is always a pull
flanner peer push DEVICE_IDSend a peer whatever it lacks
flanner peer statusHow this device is reachable, or how it reaches one peer
flanner mesh connectConnect to the team's private network, if it has one. Separate from join, which binds a repository
flanner mesh status / flanner mesh leaveWhether this device is on that network, and how to come off it
Review and retire
flanner review propose PLAN_NAMEOffer a plan's newest version for review
flanner review decide PLAN_NAMEApprove, reject, request changes, or withdraw a proposal
flanner review comment PLAN_NAMELeave a note against a quotation in a plan
flanner review status PLAN_NAMEA plan's proposals and its accepted baseline
flanner review pack PLAN_NAMEWrite a plan as one file somebody outside the team can annotate
flanner retire PLAN_NAMEAsk peers to stop showing a plan, or show it again with --restore
Project configuration
flanner config PROJECT_NAME --plan-dir DIRConfigure project settings
flanner setup-gitignore PROJECT_NAMEUpdate .gitignore manually