← Dashboard

Managing Projects

A project connects a local codebase directory to an indexed code graph and embedding store. Most users have one — teams running SourcePrep across multiple repos can register many.

Adding a project

Add projects via the CLI (prep add .) or directly in the dashboard. From the dashboard:

  1. Open the SourcePrep desktop app.
  2. Click the + button in the project list.
  3. Pick the repository folder.
  4. Optionally name it.

Watching it index

Once added, the engine starts building the index. Progress is visible in two panels:

  • Code-Graph Coverage: file inventory and traced/untraced counts.
  • Pipeline: live status of each of the 15 enrichment stages. See Graph Enrichment for what each stage does.

Controlling what gets indexed

SourcePrep respects .gitignore automatically. To exclude additional files (large assets, generated code) without git-ignoring them, use the Excludedtab in the Code-Graph Coverage panel — add patterns there and the engine will skip them on the next pass.

Pinning files

Important documentation or context files can be pinned in the Coverage panel. Pinned files are prioritized during context assembly, so they're more likely to land in your AI's context window when relevant.

Project settings

Open the Settings panel and switch to the Source sub-page for project-scoped configuration.

  • Include / Exclude globs: exact patterns for what gets indexed. Use Auto-Detect Stack to seed sensible patterns based on your repo's frameworks.
  • File size limits: the default cap (set per project) keeps massive generated files out of the embedding store. Raise it if you need to index large data files.
  • Auto-Rebuild: per-project toggle for the background watcher. On by default; turn off if you'd rather rebuild manually.

Screenshot: Source settings sub-page

Auto-Detect Stack button + glob editor.