Get your bearings.

For when you and your AI both wonder,WTF did we just vibe code?

VibeCompass keeps a live memory of your repo: what exists, why it was built that way, what changed last session, and what your next model needs to know before it touches the code.

Get started — free Read the docs

Live now · Free · Local-first files · Claude Code, Codex & Cursor

How it works

Three steps from chaos to a usable handoff.

Point it at your project

Connect a GitHub repo or use the local package to create project-memory files beside your code.

Let it build the map

VibeCompass turns the messy shape of the repo into domains, features, decisions, and file mappings.

Start the next chat with context

Claude Code, Codex, and Cursor get the handoff before they suggest a single change.

Now live on npm

Agent instructions that stay in sync with your project memory

$npm i -g @vibecompass/vibecompass

See setup

What changes

Make the next session less guesswork

Agent files

Stop maintaining four agent files by hand

Generate CLAUDE.md, AGENTS.md, .cursorrules, and Copilot instructions from one project memory — your own notes preserved outside the managed regions.

Project context

Stop re-explaining the repo

Claude Code, Codex, and Cursor start from the same map of what the app is and where the important files live.

Decision trail

Know why the code is this way

Every pattern chosen, cleanup deferred, or architecture call settled stays easy to find.

Drift checks

Catch contradictions early

On hosted projects, conflict tracking flags a later session building against old assumptions — surfaced for you to resolve, never auto-resolved.

Session handoff

Pick up where you left off

Each session leaves a usable handoff, so tomorrow's model isn't guessing from a cold start.

Before & after

Replace the rituals

Without VibeCompassWith VibeCompass

Mystery folders full of stale notesProject memory kept beside the code

Four agent files drifting apartGenerated instructions from one source

A new model asking the same questionsSessions start with the current map

Copy-pasting context into every chatContext delivered through MCP

Decisions buried in old threadsA decision trail the model can read

Finding drift after it hurtsContradictions surfaced earlier

Give the next model the story so far

Works with Claude Code, Codex, and Cursor. Connect a repo and stop starting every chat from scratch.