Docs menuCLI reference

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 init

Adopt the repository you are in: creates the store and registers the MCP server with every agent it finds

flanner init --setup codex

Register with one agent instead of all of them. Repeatable; the choices are the rows flanner status reports

flanner init --sync

Also import the plan files already in the repository. What you want when adopting one somebody else set up

flanner init --skip-claude

Register with no agent at all

flanner status

Check server status and project information

flanner doctor

Check the catalog against the plan files on disk

flanner list

List all projects

flanner list --project PROJECT_NAME

List plan files for a specific project

Plans

flanner sync

Sync existing plan files into database

flanner sync --dry-run

Preview sync without making changes

flanner sync --project PROJECT_NAME

Sync specific project only

flanner history PLAN_NAME

Every version of a plan, newest first

flanner diff PLAN_NAME 2 3

What changed between two versions

Freshness

flanner freshness

Freshness status for every plan, with the evidence behind it

flanner freshness PLAN_NAME

Status and evidence for one plan

flanner why PLAN_NAME

Why a plan is judged fresh, aging, suspect or stale

Web interface

flanner web

Launch web UI on default port (8080)

flanner web --open-browser

Launch and auto-open browser

flanner web --port 3000

Launch on custom port

MCP server

flanner start

Run the MCP server in the background on 127.0.0.1, for clients that speak http

flanner stop

Stop the MCP server

Agent integration

flanner claude-info

Show integration status

flanner setup

Re-run the agent registration on its own. flanner init already does this; use it to repair one

flanner register

Register MCP server with Claude Code

flanner register --force

Force update configuration

flanner unregister

Unregister 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 list

Browse memories rather than searching them

flanner mem show ID

One 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 ID

Stop recalling a memory, or erase it from this machine

flanner mem mode suggest

How much this project captures: off, explicit, suggest or auto-safe

flanner mem pending

Suggestions waiting on you, with approve and reject

flanner mem attach ID FILE

Attach a screenshot, PDF or recording as evidence

flanner mem share ID

Share one memory with the team. Always explicit

flanner mem withdraw ID

Ask peers to stop recalling one you shared

Your team

flanner accept TOKEN --as your-handle

Accept an invitation: joins the team and enrols this machine. Once per machine

flanner login CODE

Enrol this machine with an enrollment code from the team console

flanner whoami

This device's identity, what its entitlement allows, and which workspaces you may enter

flanner logout

Forget this device's session. The device keeps its identity

flanner join WORKSPACE_ID

Bind this repository to a workspace. Run with no id to list the ones you may use

flanner invite someone@company.com

Invite somebody to your organization (admins only)

flanner members

Your organization's members and seat count (admins only)

flanner devices

The machines enrolled under your account

Syncing with other machines

flanner peer serve

Serve this device's catalog to authorised peers. Opens no port and needs no admin rights

flanner peer start / flanner peer stop

The same thing in the background, so it keeps serving after you close the terminal

flanner peer pull DEVICE_ID

Take whatever a peer holds that this device lacks. Syncing is always a pull

flanner peer push DEVICE_ID

Send a peer whatever it lacks

flanner peer status

How this device is reachable, or how it reaches one peer

flanner mesh connect

Connect to the team's private network, if it has one. Separate from join, which binds a repository

flanner mesh status / flanner mesh leave

Whether this device is on that network, and how to come off it

Review and retire

flanner review propose PLAN_NAME

Offer a plan's newest version for review

flanner review decide PLAN_NAME

Approve, reject, request changes, or withdraw a proposal

flanner review comment PLAN_NAME

Leave a note against a quotation in a plan

flanner review status PLAN_NAME

A plan's proposals and its accepted baseline

flanner review pack PLAN_NAME

Write a plan as one file somebody outside the team can annotate

flanner retire PLAN_NAME

Ask peers to stop showing a plan, or show it again with --restore

Project configuration

flanner config PROJECT_NAME --plan-dir DIR

Configure project settings

flanner setup-gitignore PROJECT_NAME

Update .gitignore manually