Getting started · Roadmap
Roadmap
Where VibeCompass is today: what works, what’s still missing, and what’s coming next.
What works today
On your machine, free
The @vibecompass/vibecompass package keeps your project memory as files you own: architecture docs, decisions, and session notes. It runs sessions and lanes, docs review through your own AI session, and docs update. No account needed.
In your AI tool
The @vibecompass/vibecompass-mcp server lets Claude Code, Codex, Cursor, and other MCP tools read your memory mid-session, from your files or from the hosted app.
In the hosted app
vibecompass.dev adds a dashboard of your project, hosted docs reviews that come back as proposals you approve, and team sync. Connect a local folder with vibecompass login, then push. There is a free plan and a paid Solo plan.
Current gaps
The honest list of what isn’t there yet.
- Local MCP is read-only. Your AI can read your files over MCP but can't write decisions or session notes back to them. Write tools need a hosted API key, and they write to the hosted project, not your files.
- In Local mode, a feature's decisions are the decisions in its domain's decision file, not exactly that feature's, because decision entries don't record which feature they belong to. Each answer says so.
- Conflicts are tracked only in the hosted app. Local mode shows none, with a note saying where they live.
- The session brief is an experiment and stays off unless you turn it on. Evaluations haven't supported turning it on for everyone.
- When the package runs
docs reviewitself (--run-local), Anthropic is the only provider. Through your own AI session, any provider works. - The hosted app connects repositories on your own GitHub account. Organization accounts aren't supported yet.
- If you uninstall the VibeCompass GitHub App, there's no way to reconnect a project from inside the app yet.
- On Windows,
loginkeeps your sync token in a private file in your user folder, not in Windows Credential Manager. - Claude Code is checked with each MCP release. Cursor and Codex were last checked with an early version.
Coming next
What we’re working on now, with no dates. The list changes as we learn.
A project manager role
A third session role, next to builder and reviewer, that plans the work across lanes and checks that each one was reviewed before it closes.
Easier-to-read docs
A shorter Getting started, each idea explained once, and navigation that works on a phone.
A blog and public examples
Posts about building with project memory, and example projects you can browse without signing in.
Ready to try it? Getting started walks you through the install, your first session, and connecting your AI tool. Your files stay on your machine; add the hosted app later if you want it.