CodeBrainPro silently watches your coding activity, classifies your commits using Google Gemini AI, groups related work into logical tasks, and turns everything into professional reports - daily summaries, weekly logs, and appraisal documents without any manual effort.
| Feature | Description |
|---|---|
| Live Activity Tracking | Tracks edits and focus events in real time across all Git repos |
| AI Commit Classification | Classifies commits as feature, bugfix, refactor, docs, test, or chore via Gemini |
| Smart Work Unit Grouping | Clusters related commits into named logical tasks automatically |
| Report Generator | Daily / Weekly / Monthly / Appraisal reports with AI-written narratives |
| Natural Language Q&A | Ask questions like "What did I work on this week?" directly in VS Code |
| Multi-Repo Support | Tracks all workspace folders and additional configured repo paths simultaneously |
| GitHub Sync | Optionally pushes structured logs to a centralized code-brain-pro-logs GitHub repo |
| Secure Credentials | GitHub PAT (Classic) and Gemini API key stored in VS Code Secret Storage — never in plaintext |
- Download the
.vsixfrom GitHub Releases - In VS Code:
Cmd+Shift+P→ Extensions: Install from VSIX... - Select the file and reload
- VS Code
^1.115.0 - A Git repository open in your workspace
Run any sync action (CodeBrainPro: Sync to GitHub Now) and you'll be prompted for:
- Your GitHub username
- A GitHub Personal Access Token (Classic) with all
reposcopes → create one here
Credentials are stored securely in VS Code Secret Storage.
Run any AI feature (e.g. generate a report) and you'll be prompted for a Gemini key → get one here
Without a Gemini key, CodeBrainPro still works — commit classification falls back to keyword matching and reports are generated without AI narratives.
CODE BRAIN PRO
├── 📦 Work Units (This Week)
│ ├── 🟢 Auth System Refactor [feature]
│ ├── 🔴 Fix null pointer login [bugfix]
│ └── 🔵 Clean up API types [refactor]
└── 📊 Reports
├── Generate Daily Report
├── Generate Weekly Report
├── Generate Monthly Report
├── Generate Appraisal Report
└── Ask a Question...
Open with Cmd+Shift+P → type CodeBrainPro:
| Command | Description |
|---|---|
CodeBrainPro: Start Tracking |
Begin tracking |
CodeBrainPro: Stop Tracking |
Pause tracking |
CodeBrainPro: Generate Daily Report |
Last 24 hours |
CodeBrainPro: Generate Weekly Report |
Last 7 days |
CodeBrainPro: Generate Monthly Report |
Last 30 days |
CodeBrainPro: Generate Appraisal Report |
Custom date range |
CodeBrainPro: Ask About My Work |
Open AI chat panel |
CodeBrainPro: Sync to GitHub Now |
Push logs to GitHub |
CodeBrainPro: View Today's Activity Log |
Open raw activity log |
CodeBrainPro: Set Commit Interval |
Change snapshot interval |
CodeBrainPro: Clear Credentials |
Wipe stored secrets |
CodeBrainPro: Open Settings |
Jump to CodeBrainPro settings |
Reports are saved to ~/.codeBrainPro/reports/ and opened automatically after generation.
Each report includes:
- AI-generated achievement highlights (2–3 sentences, Gemini powered)
- Total active coding time and daily breakdown
- Work units with type labels and commit counts
- Repository breakdown (time + commits per repo)
- Top 10 most edited files
Appraisal example:
Cmd+Shift+P → CodeBrainPro: Generate Appraisal Report
Start date: 2026-01-01
End date: 2026-03-31
| Setting | Default | Description |
|---|---|---|
codeBrainPro.enabled |
true |
Enable/disable tracking |
codeBrainPro.idleThresholdMinutes |
5 |
Inactivity before idle |
codeBrainPro.additionalRepoPaths |
[] |
Extra repos to track |
codeBrainPro.syncEnabled |
false |
Auto-sync to GitHub |
codeBrainPro.syncFrequencyHours |
24 |
Sync frequency |
codeBrainPro.logRetentionDays |
90 |
Local log retention |
Secrets (
codeBrainPro.githubToken,codeBrainPro.geminiApiKey) are stored via VS Code Secret Storage — never in settings files.
- Source code — never transmitted anywhere
- Commit messages + diff stats — sent to Gemini API for classification (opt-in via key)
- GitHub PAT (Classic) + Gemini key — stored in VS Code Secret Storage only
- Activity logs — stored locally at
~/.codeBrainPro/, optionally synced to GitHub if enabled
~/.codeBrainPro/
├── logs/ ← Daily activity event files (JSON)
├── reports/ ← Generated reports (Markdown / JSON)
├── classifier-cache.json
└── seen-commits.json
- Fork the repository
- Clone:
git clone https://github.com/Rahulnisanth/CodeBrainPro.git - Install deps:
npm install - Build:
npm run compile - Press F5 in VS Code to launch the Extension Development Host
- Submit a pull request
- User Guide — full feature walkthrough
- Product Requirements — architecture and spec
MIT © Rahulnisanth