Skip to content

About

The multi-agent orchestrator for VS Code. Run Claude Code, Codex, and other agent CLIs that start, message, and operate each other across windows and machines.

Topics

Resources

Contributing

Security policy

Stars

296 stars

Watchers

5 watching

Forks

Latest commit

 

History

759 Commits

Folders and files

Repository files navigation

Facade Code

Facade Code

The multi-agent orchestrator for VS Code.

Run native agent CLIs, edit code, and review changes in the same IDE window. Use your own accounts and coding plans, and let agents collaborate across windows and machines.

Website: facadecode.com VS Code Marketplace: install Open VSX: install Releases: download the IDE Issues: report a bug

English · 简体中文 · 繁體中文 · Português (Brasil) · Español · Русский · Deutsch · 日本語 · Bahasa Indonesia · Français · 한국어 · Türkçe · Tiếng Việt · Polski

Watch the 2-minute demo on facadecode.com

Install

code --install-extension facade.facadecode

Or install Facade Code from the VS Code Marketplace or Open VSX. It runs on macOS (Apple silicon), Linux (x64), and Windows (x64).

Next, install and sign in to any supported agent CLIs you plan to use: Claude Code, Codex, Antigravity, Muse Code, OpenCode, or Pi. Facade Code starts each CLI using its own sign-in and account plans.

Agents run without approval prompts by default. With yolo enabled by default, agents can run commands and change files without asking first. Turn it off to restore each CLI's standard approval prompts. See the extension README.

Agent Panel

Your agents and your IDE, in the same window.

Facade Code runs native agent CLIs (Claude Code, Codex, Antigravity, Muse Code, OpenCode, and Pi) in editor terminal tabs beside your files, using each CLI's own commands, tools, accounts, and coding plans. A card in the panel tracks each agent's status.

  • Work beside your code. Each agent runs in its own terminal tab in the editor area. Closing a tab hides it while the agent keeps running; clicking its card opens it again.
  • Track status across agents. Cards show what was last sent to each agent and whether it is working, needs permission, or encountered an error, with details showing its title, folder, and who started it. Agents keep running through window reloads and extension restarts.
  • Folders and worktrees. Run agents in any workspace folder or create a Git worktree on the fly to keep code changes separate. Pin a conversation to restore it when you open the workspace again, or resume past sessions from history.

Agent Use

Let agents operate other agents, just like you.

Through MCP and a terminal protocol, agents can start, stop, find, and message other agents, read their terminal screens, type text, and press keys.

  • Start and stop agents. An agent can start other agents with any of the six CLIs, in any folder or new worktree of your Facade windows on this computer, and give them their first task. A retried request with the same request ID never starts a second agent.
  • Send messages. Agents exchange messages with each other and can message you. Facade pastes the whole message once and sends it. If unsent text or a prompt question is in the way, delivery waits until the input is clear.
  • Terminal control. An agent can read another agent's screen, type commands, and press keys to answer prompts or help a stuck peer. When a child agent waits 20 seconds for permission, an answer, or sign-in, the agent that started it is notified.

Agent Mesh

Connect agents across windows, machines, and locations.

Facade Code connects agents across your Facade windows on this computer into one network. Open a VS Code Remote SSH window to extend that collaboration to another machine.

  • Across windows. With yolo on, an agent reaches every agent across your Facade windows on this computer, local and Remote - SSH alike. With it off, an agent reaches only its own group: the agent you started and those started from it.
  • Extend over SSH. In a VS Code Remote SSH window, agents run directly on the remote machine with the tools, files, and accounts there. Local agents can start and message agents in Remote - SSH windows directly.
  • Coordinate from your phone. Connect the Claude mobile app to a Claude Code session on your computer using Claude Code Remote Control. That session can coordinate other agents through Facade and report progress back to your phone.

Remote Control requires a supported Claude Code version, an eligible plan, and full-scope sign-in. See its setup requirements.

Facade Code IDE (Preview)

Multiple projects. One window.

Organize projects, feature worktrees, and agent teams in a dedicated workspace bar. Switch between projects with their relevant files and terminals, while agents continue working in the background.

Download the IDE preview: macOS (Apple silicon, .dmg) · Windows (x64, .exe) · Linux (Ubuntu x64, .deb) · All releases

The IDE is a fork of VS Code that installs alongside your existing editor and shares nothing with it: settings, extensions, and the facade command are completely separate. Its extensions come from Open VSX; a few proprietary Microsoft extensions, such as Remote Development and C/C++, run only in official Microsoft builds. Architecture and specifications are in docs/ide/.

Building from Source

For contribution guidelines and branch discipline, see CONTRIBUTING.md and docs/ide/ENGINEERING.md.

Feedback

  • Bugs & ideas: GitHub Issues, or Help > Report Issue in the IDE.
  • Security vulnerabilities: Please report privately according to SECURITY.md.

License

MIT, matching upstream VS Code. See LICENSE.txt for Microsoft's copyright notice and Facade Code contributors' notices.

Facade Code is an independent product and is not affiliated with, endorsed by, or sponsored by the providers of the third-party tools shown. All third-party trademarks and logos belong to their respective owners.

About

The multi-agent orchestrator for VS Code. Run Claude Code, Codex, and other agent CLIs that start, message, and operate each other across windows and machines.

Topics

Resources

Contributing

Security policy

Stars

296 stars

Watchers

5 watching

Forks

Releases

Packages

Contributors

Languages