BlocWeave — AI Coding Assistant
Bilingual AI pair programmer built for English and French-speaking developers across Africa and beyond.
Chat with your codebase, generate and apply multi-file changes with Agent Mode, get inline completions, and run code actions — all from inside VS Code, with responses in the language you choose.
Features
Chat
Open a persistent chat panel (Ctrl+L / Cmd+L) and ask questions, request code changes, or explore your project. Responses stream in real time. BlocWeave automatically includes context from the active editor and lets you mention specific files or search the codebase with @codebase. Use the + button to attach any file as context, or pick a model tier from the selector in the input bar.
Model tiers: Auto (default) · Chat · Agent · Reasoning · Fallback
In Auto mode BlocWeave classifies each request and routes it to the cheapest model that can handle the task — simple refactors and edits use a fast cheap model, complex multi-file agent tasks use the full model. You can always override by picking a specific tier.
Agent Mode
Press Ctrl+Shift+L / Cmd+Shift+L to open the task panel. Describe what you want to build or fix. BlocWeave classifies the task, reads the relevant workspace files, proposes a structured action plan (write, edit, mkdir, run tests), and shows a diff for every file before applying anything. You approve each step.
- Supports create, edit, delete, rename, and multi-file changes
- Blocks writes to
.env, .git, node_modules, and credential files
- Runs only from an approved command list (npm, yarn, pnpm, git, tsc, pytest, cargo, go, etc.)
- Up to three auto-repair iterations if a test command fails after applying changes
Slash Commands
Type / in the chat input to see the command menu:
| Command |
What it does |
/explain |
Explains the selected code — or the whole current file if nothing is selected |
/fix |
Fixes bugs in the selected code or the whole file |
/tests |
Generates tests for the selected code or the whole file |
/review |
Deep code review (uses the reasoning model) |
/commit |
Drafts a commit message from your staged changes |
/template |
Pick a project blueprint and write it to BLOCWEAVE_PLAN.md |
If you have a selection, the command runs against it. If not, BlocWeave uses the currently open file automatically — no need to select first.
Code Actions
Right-click a selection for quick inline actions:
| Action |
Shortcut |
| Explain Code |
Ctrl+Shift+E / Cmd+Shift+E |
| Refactor Code |
Ctrl+Shift+I / Cmd+Shift+I |
| Review Code |
Right-click menu |
| Generate Tests |
Right-click menu |
Refactor and test generation show an inline diff you can apply with one click.
Inline Completions
BlocWeave suggests completions as you type. Completions are cached locally for 24 hours so they work even when offline. Toggle them off in Settings (blocweave.autocomplete.enable).
Bilingual
Set blocweave.language to en, fr, or auto (follows your VS Code locale). All UI messages, AI prompts, and responses respect this setting.
Requirements
Getting Started
Search for BlocWeave in the VS Code Extensions panel (Ctrl+Shift+X) and click Install.
Alternatively, download the .vsix from the latest GitHub Release and drag it onto VS Code, or install from the command line:
macOS / Linux:
code --install-extension blocweave.blocweave
Windows (PowerShell):
code --install-extension blocweave.blocweave
After installing:
- Open VS Code and click the BlocWeave icon in the Activity Bar (left sidebar).
- Sign in: open the Command Palette (
Ctrl+Shift+P) → BlocWeave: Sign in. Your browser opens blocweave.com. After signing in, VS Code is authenticated automatically.
- Press
Ctrl+L to open the chat panel and send your first message.
Updates: BlocWeave checks for new releases automatically and shows a notification when one is available. Click Update to install in one step — no manual download needed.
Commands
| Command |
Description |
BlocWeave: Sign in |
Open browser sign-in flow |
BlocWeave: Sign in with Token |
Manual token entry (fallback) |
BlocWeave: Sign out |
Clear stored credentials |
Open BlocWeave Chat |
Open the chat panel |
BlocWeave: Agent Mode |
Open the Agent Mode task panel |
BlocWeave: Explain Code |
Explain the selected code |
BlocWeave: Refactor Code |
Refactor the selected code |
BlocWeave: Review Code |
Review the selected code for issues |
BlocWeave: Generate Tests |
Generate tests for the selected code |
Configuration
| Setting |
Default |
Description |
blocweave.language |
auto |
Language for UI and AI responses (auto, en, fr) |
blocweave.defaultModelTier |
auto |
Default model tier (auto, chat, agent, reasoning, fallback) |
blocweave.autocomplete.enable |
true |
Enable or disable inline completions |
blocweave.apiBaseUrl |
https://api.blocweave.com |
API gateway URL (leave as default) |
Agent Mode in Detail
Agent Mode classifies your request into a task pattern (CRUD feature, UI, API route, auth, data model, bugfix, test suite, refactor, or integration) and infers the workspace conventions (package manager, frameworks, test command). It reads the relevant files and proposes a final action plan.
Each proposed action shows a file diff. You approve writes and deletes individually. If a run-tests step fails, BlocWeave can attempt a repair and re-run automatically, up to three times.
Blocked actions: writes to .env*, .git/, node_modules/, dist/, build/, and any path matching *secret* or *credential* are always blocked. Shell commands outside the approved list are rejected.
Sign-In Flow
BlocWeave: Sign in opens https://blocweave.com?source=vscode in your browser. After signing in with Google or email, the site redirects back to VS Code automatically. Your session token is stored in VS Code SecretStorage — it is never written to disk in plain text. The token refreshes silently in the background before it expires.
If your session expires, BlocWeave clears it and prompts you to sign in again.
Privacy
BlocWeave sends your prompts and selected code context to the BlocWeave API for model inference. No code is stored permanently — requests are processed and discarded. Your credentials are stored exclusively in VS Code SecretStorage. Usage and cost metadata (token counts, GHS cost estimates) are returned with each response to keep you informed of your balance.
Troubleshooting
Sign-in doesn't redirect back to VS Code
Make sure VS Code is registered as the handler for vscode:// URIs on your OS. On Linux, this is set automatically by the VS Code installer. If the automatic flow fails, use BlocWeave: Sign in with Token and paste a token from the BlocWeave dashboard.
"Missing auth" error
Your session has expired. Run BlocWeave: Sign out then BlocWeave: Sign in to refresh.
Inline completions not appearing
Check that blocweave.autocomplete.enable is true in Settings. Completions only trigger automatically (not on manual Ctrl+Space). If your project is large, the first completion may take a moment while the workspace context is indexed.
Agent Mode shows "no workspace is open"
Open a folder in VS Code (File → Open Folder) before running Agent Mode.
