Quick Start

1Launch SourcePrep

Open the SourcePrep desktop app. It automatically starts the background daemon that manages the index and serves requests.

Power users: you can also run prep serve in a terminal.

2Index Your Repo

Click the + button in the sidebar, select your project folder, and SourcePrep will scan and build the Code Graph immediately.

Or via CLI: prep add ~/my-project

3Connect MCP

Configure your editor (Cursor/Windsurf) to use the local server.

4Select Files & Get Ambient Context

In the SourcePrep dashboard, use the Knowledge Sources tree to select the files and folders you want to work with. Then in your editor's AI chat, simply call:

"prep"

SourcePrep will feed the AI its ambient project baseline: your hub files, module structures, and focus areas. The AI immediately understands the architecture before you ask your first prompt.

Now ask your first question — the AI already knows your architectural context:

"How does the authentication middleware interact with the user service? Trace the calls."

5Audit Your Codebase

Once orienting your agent, safely run a structural audit to find architectural issues, tech debt, and quality gaps — no LLM required:

"Audit my codebase"

The agent will call prep_audit, executing 11 deterministic analyzers against the trace graph. You'll get severity-tagged findings like ARCH-1 (circular dependency). To act on a finding, you can ask the agent to fix it, and it will use action="refactor" to generate a plan. See the Codebase Audit Guide for details.