Understand a project
“Give me a map of this repository. Show me the entry points and trace one important request end to end.”
Getting started
Bwat for Code
Bwat is an AI coding agent that reads your project, edits files, runs commands, and checks its work. Use it beside your code in VS Code or directly from a terminal.
On this page
Available in VS Code and the terminal
Get started
Pick the surface that matches how you work. Both use the same Bwat account and the same agent, so you can change your mind later.
Work beside your code
Install the extension, open a project folder, then select the Bwat icon in the Activity Bar. Your first session opens a browser so you can sign in.
Install from MarketplaceWindows, macOS, and Linux
Both surfaces run the same Bwat agent and use the same account.
Start with a real task
Bwat works best when the request has a clear outcome. Copy one of these into a project you know, then adjust the details.
Fix a bug
“Reproduce the failing login test, find the root cause, fix it, and run the relevant tests.”
Build a feature
“Add a compact theme switcher that follows the existing component patterns. Implement it and verify the build.”
Review a change
“Review my current diff for correctness and regressions. Prioritize issues that can affect users.”
How Bwat works
A Bwat session is a loop you can watch and steer. It gathers enough context to act, uses the tools the task needs, then checks the result.
- 01
Open the project
Bwat starts from the folder or workspace you opened, so it can discover the code and project instructions already there.
- 02
Describe the outcome
Tell it what should be true when the work is done. Add constraints, examples, errors, or a command that proves the result.
- 03
Review the work
Bwat reads, searches, edits, and runs commands. Your permission mode decides which actions pause for approval.
- 04
Verify together
Bwat runs the relevant checks and summarizes what changed. You remain the final reviewer of every result.
Two surfaces, one agent
Choose by interface, not capability. The engine, tools, project instructions, private project memory, and saved sessions are shared on the same machine.
VS Code extension
Best when you want native diff review, editor selections, file mentions, and the agent beside the code.
Use Bwat in VS CodeTerminal CLI
Best over SSH, inside containers, in scripts, or whenever your workflow already lives at a prompt.
Use Bwat in a terminalIn both surfaces, you choose how much Bwat can do before asking. Start with Manual mode while you learn the workflow.
Next steps
Follow the quickstartInstall Bwat and land one small, reviewed change.Try common workflowsUse tested prompt patterns for everyday development work.Choose a permission modeDecide what runs immediately and what waits for you.Add project instructionsTeach Bwat the rules and architecture it should remember.Browse the prompt libraryCopy a strong starting point for the task in front of you.Use a specialized skillSee the workflows currently available in VS Code and CLI.Work well with BwatKeep sessions short, mention files, and steer the agent early.