# VBridge Agent — Full Content

> VBridge Agent is the first framework that puts Claude Code inside the Excel VBA development loop. Claude writes new VBA, imports it to the VBE, runs 45+ automated checks, reads its own test log, and fixes root causes autonomously — without copy-paste and without the live workbook ever being at risk.

- **Website:** https://vbridge.netlify.app/
- **Hebrew version:** https://vbridge.netlify.app/he
- **Built by:** Noam Brand (independent VBA developer & automation engineer)
- **Contact:** noambbb@gmail.com
- **Upwork:** https://www.upwork.com/freelancers/~017d992908340102a8
- **Platform:** Windows 10 / 11, Microsoft Excel with VBA
- **Requires:** Claude Code CLI, Claude Pro or Max subscription
- **License / Price:** Free

---

## What it is

VBridge Agent turns the Excel VBA Editor — historically a closed door to AI — into a place where Claude Code can develop, test, and self-correct VBA on its own. The bridge is built on native Windows scripting that ships with every Windows install, so no new runtimes, interpreters, admin rights, or IT exceptions are required. Everything runs locally; no code, workbook, or data ever leaves the developer's machine.

VBridge lets Claude Code drive Excel/VBA autonomously — exports modules from the workbook, edits them as files, reimports, runs the procedures, captures logs and errors, and iterates. No copy-paste loop, no IDE plugin. Works on existing .xlsm/.xlsb projects, so it handles real legacy workbooks — not just new toy projects.

---

## The problem VBridge solves

Every VBA developer using ChatGPT or Claude right now is stuck in the same exhausting cycle. Not because they are doing it wrong — because the tools have no way to close the loop themselves.

The current workflow:

1. Ask the AI for VBA code.
2. Copy the code.
3. Paste it into the VBE.
4. Run it.
5. Compile error, runtime error, wrong result — or worse, it runs fine and silently breaks something else.
6. Copy the error.
7. Paste the error back to the AI.
8. Wait. Read the new suggestion. Paste it again.
9. Repeat until it works by accident, or give up.

Half the session is spent testing manually. Bugs pile up. Every fix risks breaking something else. Progress is slow. Documentation is whatever you remember to ask for. And the developer does all of it — AI just watches and suggests.

**The hidden cost:** VBA developers know Excel deeply. Instead of using that knowledge to design and build, they spend it on copy-paste and on translating between the tool and their environment.

---

## How VBridge closes the loop

The same Claude that used to give one function at a time becomes something that develops, tests, finds its own bugs, fixes them, and confirms everything passes — autonomously.

Pipeline (every session):

1. **Isolated copy** — every session runs on a protected copy. Claude never touches the live file. One click restores exactly where you started, no matter what happens during the session.
2. **Direct VBA editing** — no copy-paste. Claude edits VBA source files directly and imports through a safe bridge — fully automatic, with no manual VBE work.
3. **45+ automated checks** — verify output against expected results. A checklist that runs itself every time Claude touches anything. Pass/Fail in seconds — no manual testing.
4. **Self-reading test log** — Claude reads its own test output and identifies failures by itself.
5. **Root-cause fixing with permanent guards** — every fix gets a permanent guard check added so the same bug cannot come back.
6. **Full Auto mode** — say "full auto" and Claude keeps cycling (test → fix → guard → recheck) until a full scan finds nothing.

---

## Key capabilities

- Claude writes VBA and imports it directly into the VBE (no copy-paste)
- 45+ automated checks after every change (syntax, compile, runtime, regression)
- Claude reads its own test log and identifies failures by itself
- Autonomous root-cause fixing with permanent guard checks added after each fix
- Isolated-copy safety: every session runs on a protected copy — the live workbook is never touched and can be restored with one click
- 100% local execution — code, workbooks, and data never leave the machine
- Documentation is generated automatically as a side-effect of the test loop
- Works on existing legacy .xlsm / .xlsb projects, not only greenfield code

---

## Who it's for

- VBA developers, Excel power users, and financial / operations engineers maintaining large Excel-based systems
- Teams that cannot use cloud-based AI coding tools because of data sensitivity or IT restrictions
- Developers who have tried general AI assistants for VBA and found them only useful for tiny snippets, not full development cycles

---

## How it differs from alternatives

**Other AI tools touch the spreadsheet from the outside** — reading data, writing formulas, filling cells. VBridge Agent is the only one that puts Claude inside the VBA editor itself, to write code, run it, and fix what breaks on its own.

| Capability | VBridge Agent | Manual copy-paste | Claude Excel add-in | MCP Excel Server |
|---|---|---|---|---|
| Autonomous VBA writing | ✓ | ✓ | partial | ✗ |
| Imports into VBE automatically | ✓ | ✗ | ✗ | ✗ |
| Runs procedures and reads output | ✓ | ✗ | ✗ | ✗ |
| 45+ automated checks per change | ✓ | ✗ | ✗ | ✗ |
| Reads own log and self-fixes | ✓ | ✗ | ✗ | ✗ |
| Parallel/isolated-copy development | ✓ | ✗ | ✗ | ✗ |
| Auto-documentation | ✓ | ✗ | ✗ | ✗ |
| No server / Python / npm | ✓ | ✓ | ✓ | required |
| Install in minutes | ✓ | ✓ | ~10 min | 30+ min |
| Local execution (zero cloud) | ✓ | ✓ | ✗ | depends |

**Detailed:**

- **Claude / ChatGPT Excel add-ins** — operate on spreadsheet *cells* and have zero access to the VBA editor or to any macro the user runs. VBridge Agent runs the full write → import → test → fix loop inside the VBE.
- **General AI chat (copy-paste workflows)** — require the human to be the runtime: paste code, run it, read the error, paste it back. VBridge Agent removes the human from that loop.
- **Excel MCP servers** — focused on reading/writing cells, not on developing VBA code with feedback from runtime errors.
- **Claude.ai (chat)** — a chat: you ask, it answers, but it can't touch your files. Claude Code CLI has access to your files, commands, and scripts, meaning it can take real actions — VBridge uses exactly that capability.

---

## Installation

Two installation tracks ship with the framework. Both run locally on Windows or macOS, no server required, no admin rights, no IT exception.

1. **ClaudeCode Launchpad** — zero-setup Claude Code for English / LTR languages on Windows & macOS. Bright blue terminal theme, visual folder picker (no `cd` commands), preserves the original Claude Code experience.
2. **Kivun Terminal** — Claude Code with full RTL support for Hebrew, Arabic, Persian and other RTL languages. Same bright blue terminal theme.

Both tracks include all required scripts pre-configured — no settings to tweak.

---

## FAQ

**How is this different from ChatGPT or general Claude usage for VBA?**
ChatGPT gives you code — and you still do everything else: copy, paste into the VBE, run it, see what broke, go back and explain. VBridge Agent lets Claude Code close that loop itself. You describe what to build — it writes, imports, tests and fixes. No copy-paste, no waiting, no explaining errors.

**How is this different from the Claude add-in for Excel?**
The Claude add-in for Excel works inside Excel — it can help you draft code in chat, but it cannot import it to the VBE, run checks, read the error log, or fix itself. VBridge Agent runs outside Excel via Claude Code CLI — a system capable of managing a complete, autonomous development cycle.

**Do I need to know DOS / terminal commands?**
No. You use exactly two commands: `cd [folder-path]` to navigate to your project folder, and `claude` to launch Claude Code. From that moment on, the work happens in natural language.

**Is my live workbook safe during a session?**
Yes. Every session runs on a protected isolated copy. Claude never touches the live file, and one click restores you exactly to your starting point.

**Is Claude.ai the same as Claude Code CLI?**
No. Claude.ai is a chat — you ask, it answers, but it cannot touch your files. Claude Code CLI is Claude with access to your files, commands and scripts on your machine — meaning it can take real actions, not just give suggestions. VBridge uses exactly that capability.

**Is Hebrew supported?**
Yes. The Kivun Terminal installation track ships with full RTL support, including for Hebrew, Arabic, Persian and similar languages.

**What does a session look like?**
A 120-minute session: installation and setup on your own project, a walkthrough of the recommended workflow, and a first working session on a real task — so you leave with a tangible result, not just theoretical understanding.

---

## Contact

- **Developer:** Noam Brand
- **Email:** noambbb@gmail.com
- **Upwork:** https://www.upwork.com/freelancers/~017d992908340102a8

## Resources

- [Home (English)](https://vbridge.netlify.app/)
- [Home (Hebrew)](https://vbridge.netlify.app/he)
- [Short llms.txt summary](https://vbridge.netlify.app/llms.txt)
- [Sitemap](https://vbridge.netlify.app/sitemap.xml)
- [Open Graph image](https://vbridge.netlify.app/claude_code_vbridge.png)