Getting Started
Install the WOZCODE plugin for Claude Code in under a minute.
Quick Start
Run these commands in Claude Code to get started.
Don't have Claude Code? Install it first →
1
Add the WOZCODE plugin to your marketplace
claude plugin marketplace add WithWoz/wozcode-plugin
2
Install the agent
claude plugin install woz@wozcode-marketplace
3
Quit and restart Claude Code
Close your current Claude Code session first, then navigate to your project and run this command in your regular terminal.
claude
4
Verify installation — look for woz:code on the right side of the text input field
This badge means the WOZCODE agent is active and ready to use.
5
Log in to your Woz account
/woz-login
Headless / SSH? If you can't open a browser, log in with your token directly:
/woz-login --token 'YOUR_TOKEN'
Get your token from build.withwoz.com/wozcode/token after subscribing.
6
Allow browser permissions
On desktop, a browser window will open. When build.withwoz.com asks to access other apps and services on this device, click Allow.
Updates & Reinstall
Keep your plugin up to date.
1
Update WOZCODE to the latest version
/woz-update
2
Reload plugins to apply the update
/reload-plugins
Benchmark Your Savings
Want proof? Run a side-by-side comparison of WOZCODE vs vanilla Claude Code on your own codebase. Each prompt runs twice — once with WOZCODE, once without — so you can see exactly how much you save in cost, tokens, turns, and time.
1
Open Claude Code in a clean git repo you want to test on
The benchmark resets the repo between runs, so make sure all your work is committed.
2
Run the benchmark
/woz-benchmark
You'll be asked for 2–10 coding prompts — pick real tasks like feature builds, refactors, or bug fixes. Trivial one-liners won't show the difference.
3
Review your savings report
The benchmark runs each prompt with both WOZCODE and vanilla Claude Code, then prints a detailed comparison showing cost, tokens, turns, and time for every task — plus your aggregate savings.
Quick Start
Set up WOZCODE in Claude Code Desktop.
Don't have Claude Code? Install it first →
1
Add the WOZCODE plugin to your marketplace
claude plugin marketplace add WithWoz/wozcode-plugin
2
Install the agent
claude plugin install woz@wozcode-marketplace
3
Quit and restart Claude Code
Close your current Claude Code session, then reopen Claude Code Desktop.
4
Start a new Claude Code session
Ask this in a new session — it should answer
woz:code.what main thread agent are you running?
5
Log in to your Woz account
/woz-login
Updates & Reinstall
Keep your plugin up to date.
1
Update WOZCODE to the latest version
/woz-update
2
Reload plugins to apply the update
/reload-plugins
Quick Start
Follow these steps inside the Claude panel in VS Code desktop.
1
Open Claude command menu
Inside the Claude input, type "/" to open the command menu.
2
Select "Manage plugins"
Choose "Manage plugins" from the dropdown.
3
Open "Marketplaces" tab
In the Manage Plugins window, switch to the "Marketplaces" tab.
4
Paste Woz marketplace repository
Paste this GitHub repository URL into the input field and click "Add". This registers the Woz marketplace.
https://github.com/WithWoz/wozcode-plugin
5
Switch to "Plugins" tab
After adding the marketplace, go to the "Plugins" tab.
6
Search for woz plugin
Type "woz@wozcode-marketplace" in the search input to find the plugin. Click "Install".
woz@wozcode-marketplace
7
Click "Restart" to apply changes
Updates & Reinstall
Use these steps if you need to refresh or re-add the Woz marketplace in VS Code.
1
Open Manage Plugins
Type "/" and select "Manage plugins".
2
Reload the marketplace
In the Marketplaces tab, click the refresh icon next to the Woz marketplace to load the latest plugins.
3
Reinstall the plugin
Turn the Woz plugin off and back on, or remove it and install it again from the Plugins tab.
4
Click "Restart" to apply changes
Quick Start
Connect WOZCODE to Conductor.
Don't have Claude Code? Install it first →
1
Add the WOZCODE plugin to your marketplace
claude plugin marketplace add WithWoz/wozcode-plugin
2
Install the agent
claude plugin install woz@wozcode-marketplace
3
Quit and restart Claude Code
Close your current Claude Code session, then reopen it.
4
Install WOZCODE for Conductor and get the executable path
wozcode conductor
5
Paste it into Conductor → Settings → Advanced → “Claude Code executable path”
6
Start a new Conductor session
Ask this in a new session — it should answer
woz:code.what main thread agent are you running?
7
Log in to your Woz account
/woz-login
Updates & Reinstall
Keep your plugin up to date.
1
Update WOZCODE to the latest version
/woz-update
2
Reload plugins to apply the update
/reload-plugins
CLI Reference
| Command | Description |
|---|---|
| /woz-status | Check authentication status |
| /woz-login | Log in to your Woz account |
| /woz-logout | Clear credentials |
| /woz-recall | Recall saved context and preferences |
| /woz-savings | Show estimated savings report (roundtrips, time, tokens, cost) |
| /woz-benchmark | Run a side-by-side cost comparison of WOZCODE vs vanilla Claude Code on your repo |
| /woz-settings | Configure WOZCODE plugin settings |
| /woz-update | Update the WOZCODE plugin to the latest version |
| /reload-plugins | Reload plugins to get latest updates |
| /woz | Show all available WOZCODE commands |
| claude plugin disable woz@wozcode-marketplace | Temporarily disable the plugin |
| claude plugin enable woz@wozcode-marketplace | Re-enable the plugin |
| claude plugin marketplace remove WithWoz/wozcode-plugin | Remove the plugin from marketplace |
| claude --agent woz:code | Launch Claude Code with WOZCODE agent explicitly |
| wozcode status | Check authentication status from your terminal |
| wozcode login | Log in to your Woz account from your terminal |
| wozcode logout | Clear credentials from your terminal |
| wozcode conductor | Print the WOZCODE executable path for Conductor |
| wozcode benchmark | Run a side-by-side cost comparison of WOZCODE vs vanilla Claude Code on your repo |