Branxa bridges the gap between your Git history and your AI workflow. This extension brings the high-fidelity context capture of Branxa directly into your VS Code status bar and command palette.
🚀 Quick Start
Install the CLI: The extension depends on the Branxa CLI logic.
npm install -g @thelogicatelier/branxa
Initialize your project: Open your project in VS Code and run Branxa: Init from the Command Palette (Cmd+Shift+P).
Save Context: Use Branxa: Save Context whenever you finish a task or reach a milestone.
Resume Everywhere: Use Branxa: Resume Context to copy a high-fidelity prompt to your clipboard for your AI assistant.
✨ Features
📊 Status Bar Insights
See your current Task and State at a glance in the bottom right corner. Click the status bar item to instantly copy your resume prompt to the clipboard.
📝 Interactive Save Flow
Never forget what you were doing. The Save command opens native VS Code input boxes to help you quickly document:
Task: What you just finished.
Goal: The high-level objective.
Current State: Where the code stands technically.
🕰️ History & Drift
Branxa: View History: Interactive log of your previous context entries.
Branxa: Show Drift (Diff): See exactly what has changed in your codebase since your last saved context.
💡 Gotchas & Pro-Tips
[!TIP]
Git Hooks Integration: If you enable hooks via the CLI (branxa config set hooks.enabled true), the status bar will automatically update on every commit!
Branch Awareness: Branxa stores context per-branch. When you switch Git branches in VS Code, the extension automatically loads the context for the new branch.
Local First: All data is stored in a hidden .branxa/ folder in your workspace root. It never leaves your machine unless you explicitly use branxa share.
Node Version: Ensure you are running Node 22+ for the best performance with the underlying CLI.
🛠️ Configuration
You can customize the extension behavior in your User Settings (settings.json):
branxa.autoResumeOnStartup: (Default: true) Automatically show the resume prompt when opening a Branxa-enabled workspace.
branxa.cliPath: (Default: npx @thelogicatelier/branxa) Path to the Branxa CLI binary if you prefer a global installation or a specific version.
