ARC: Copilot Bridge
Lets an AI agent (any assistant that can run PowerShell on your PC) drive GitHub Copilot Chat inside a specific VS Code project window without stealing focus, read the results, and get woken by a webhook when a chat finishes.
Install
- Install the
.vsix: Extensions → ⋯ → Install from VSIX… (or code --install-extension arc-copilot-bridge-1.0.0.vsix).
- Reload any VS Code windows that were already open. New windows hook in automatically.
- Open the ARC icon in the Activity Bar, then click Setup:
- your agent's name
- (optional) a webhook URL and key for auto-wake
- Flip the Watcher switch on if you use auto-wake.
The scripts are installed to ~/copilot-bridge (change it with the arc.bridgeDir setting). Your webhook settings are kept in config.json there, on this PC only.
For the agent
$B = "$HOME\copilot-bridge"
& "$B\list.ps1" # windows that are hooked in, with their folders
& "$B\send.ps1" -Workspace "C:\path\to\project" -Prompt "..." -Label task1 [-Mode ask|edit|agent] [-Wait]
& "$B\read.ps1" -Tag <tag> # or -List -Recent 10
& "$B\archive.ps1" -Workspace "C:\path\to\project" [-Purge] # archive (or wipe) that project's chats; you confirm in VS Code
& "$B\read.ps1" -Archive [-Project name] [-Search text] # browse archived chats; -File <path> prints one
& "$B\bridge.ps1" status|start|stop|mode both|webhook|wait|scope bridge|all
Archive and purge
- Archive chats saves each finished chat for the current project to
~/copilot-bridge/archive/<project>/ as a readable Markdown transcript, plus the raw log in raw/. It then removes those chats from Copilot. Running chats are left alone.
- Purge deletes every Copilot chat for the project and that project's archive. Nothing is kept.
- Both ask you to confirm twice: once in ARC and once in VS Code. Archived chats appear in the dashboard's Archive tab.
Safety
- Each window only accepts prompts for its own folder. If the project isn't open, or is open in more than one window, nothing is sent.
- The window servers listen on 127.0.0.1 only, with a random token for each window.
- The
wrong-workspace status is returned if Copilot's session reports a different folder.
Webhook payload
POST JSON with source, machine, label, sessionId, workspace, status (done|needs-approval), reply, pendingApprovals, changedFiles, sent with the header Authorization: Bearer <key>.
Per-project agents
Each project can report to its own agent (for example a "Neo Arc Orchestrator"), while everything else goes to the default agent.
- In the ARC panel, click Give it its own agent under the watcher (or run ARC: Give This Project Its Own Agent).
- Enter that agent's name, webhook URL, and key. They're stored only in your local
config.json under projects.
- Finished chats in that folder now wake that agent; other projects keep going to the default agent. The webhook payload includes
agent so the receiver knows which route fired.
- To undo, run the same command and choose Remove.