Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/swt-labs/vibe-better-with-claude-code-vbw/llms.txt

Use this file to discover all available pages before exploring further.

VBW installs directly inside Claude Code using the plugin system. The entire process takes two commands.

​
Prerequisites

  • Claude Code v1.0.33 or later (recommended: v2.1.47+)
  • Model: Opus 4.6 or later (VBW is designed specifically for this model)
  • Operating system: macOS or Linux
  • jq — the only external dependency. Install with brew install jq (macOS) or apt install jq (Linux). VBW checks for jq during /vbw:init and warns clearly if it’s missing.
Windows is not natively supported. All hooks and scripts require bash. If you’re on Windows, run Claude Code inside WSL first.

​
Installation steps

1

Add the marketplace

Open Claude Code and run this command inside the Claude Code session:
/plugin marketplace add yidakee/vibe-better-with-claude-code-vbw
2

Install the plugin

After the marketplace command completes, run:
/plugin install vbw@vbw-marketplace
Run these two commands one at a time, as separate inputs. Do not paste both lines together — Claude Code will treat them as a single command and the URL will break.
That’s it. VBW is now installed and its commands are available in your Claude Code session.

​
Running VBW

Choose how much you want Claude Code to interrupt you for permission prompts.
Start Claude Code normally:
claude
Claude Code will ask for permission before file writes, bash commands, and other tool use. You approve once per tool, per project — it remembers after that. VBW’s own security layer (agent tool permissions, file access hooks, database safety guard) still applies on top of these prompts, giving you two layers of oversight.Recommended if this is your first time using VBW or agent teams.

​
Updating VBW

To update VBW to the latest version, run inside Claude Code: 
/vbw:update

​
Uninstalling VBW

To remove VBW, run inside Claude Code: 
/vbw:uninstall

​
Next step

Quickstart

Run your first VBW project from init through a completed phase.

Build docs developers (and LLMs) love

Get started for freeTalk to us