Managing Projects

Adding Projects

You can add projects via the CLI (prep add .) or directly in the Dashboard.

1. Open the SourcePrep desktop app.
2. Click the "+" button in the sidebar project list.
3. Select your repository folder using the file picker.
4. Give it a friendly name (optional).

Indexing Status

Once added, SourcePrep starts learning about your codebase through the Knowledge Pipeline (Panel B) — first building the structural map, then layering in meaning and relationships:

• Structural Trace: (Rust) Fast parsing of your codebase structure.
• Vector Indexing: (Embeddings) Creating searchable chunks for the knowledge base.

File Management

Use the Graph Scope panel (Panel A) to manage what gets indexed.

Excluding Files

SourcePrep respects your .gitignore automatically. To exclude additional files (like large assets or generated code) without git-ignoring them:

• Go to the Excluded tab in the Graph Scope panel.
• Use the interface to add patterns or manage ignored files.

Pinning Files

Important documentation or context files can be Pinned within the Scope view. Pinned files are prioritized in context assembly.

Project Settings

Click the Settings tab in the dashboard to configure project-specific options.

• Include/Exclude Patterns: Fine-tune exactly which files are indexed. Use Auto-Detect Stack to have SourcePrep scan your repo and suggest patterns for your framework.
• File Size Limits: Adjust the max file size threshold (default 10MB) if you need to index large data files.
• Auto-Rebuild: Toggle the background watcher for this specific project.