Codebase Context

The AI Codebase Profile is an automatically generated summary of your repository that gives Vibe deep understanding of your codebase.

What's in the profile

The codebase profile is a structured document that typically includes:

• Tech Stack — Languages, frameworks, and key dependencies detected from your project files
• Architecture — Application structure, directory layout, and design patterns
• Key Patterns & Conventions — Coding style, naming conventions, and architectural patterns used in your codebase
• Database Schema — Tables, relationships, and key models (if a schema file is present)
• Important Notes — Any noteworthy configuration, deployment setup, or project-specific details

Viewing the profile

1. Navigate to your project
2. Click the Context tab
3. Select the Codebase Context sub-tab
4. Below the repository info, you'll see the AI Codebase Profile section

The profile is read-only and rendered as formatted markdown. It's regenerated each time you refresh the code context.

How AI uses the profile

The codebase profile is automatically injected into AI prompts for:

• Sprint generation — Stories reference real files, classes, and patterns from your codebase
• Vibe chat — Vibe can answer questions about your architecture and suggest implementations that match your existing patterns
• Task generation — Tasks include specific file paths and framework-appropriate implementation steps

This means instead of generic stories like "Add authentication," you get specific stories like "Add Devise authentication with User model at app/models/user.rb, configure routes in config/routes.rb."

Refreshing the profile

Your codebase changes over time. To update the profile:

1. Go to the project's Context → Codebase Context tab
2. Click the refresh button (↻ icon) next to the repository name
3. Wait for the sync to complete (you'll see the syncing spinner)

The profile will be regenerated based on the latest state of your repository's default branch.

Profile size and limits

• File tree — Up to 500 file paths are indexed
• Raw context — Up to ~50KB of key file contents are fetched
• AI profile — Approximately 2000 words, adding ~2500 tokens to AI prompts

These limits ensure fast sync times and keep AI prompts within context window limits.

Does syncing count against AI usage?

No. Code context sync is treated as infrastructure — it does not count against your monthly AI generation limit.