Docs / Troubleshooting
Troubleshooting
Common problems and the command that fixes each one.
Claude Code doesn't see the MCP server
Register the server, then restart Claude Code so it reloads the config.
flanner registercommand not found: flanner
Reinstall, or run it as a Python module.
python -m flanner.cli --helpDatabase not initialized
Run init from inside your project. The database lives at ~/.flanner/data.db.
flanner initPlan files aren't showing up
Sync the .plans/ directory into the database.
flanner syncIf none of these apply, run flanner doctor. It checks the catalog against the files on disk and reports what it finds.