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

481 stars

Watchers

5 watching

Forks

Latest commit

 

History

1,135 Commits

Folders and files

Repository files navigation

Facade Code

Facade Code

Run AI coding agents across your machines.

Facade Code runs a group of AI coding CLIs on your own machines. Agents can find and message each other, read screens and type into terminals. You can direct them from Shell, VS Code or any application that supports MCP. Each machine runs its own Orchestrator, and your machines connect over SSH.

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

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

Upstar: #4 Riser Of The Week in Editors & IDEs, November 9–15, 2026

Watch the 2-minute demo on facadecode.com

Install

Shell

The one-line installers become available with the first release that includes standalone packages. Shell packages cover macOS, Linux and Windows on x64 and arm64.

Run this command on macOS or Linux.

sh -c 'script=$(curl -fsSL "$1") && sh -c "$script" --' facade-install https://github.com/y5ez3g/facadecode/releases/latest/download/install.sh

Run this command in PowerShell on Windows.

$response = Invoke-WebRequest -UseBasicParsing 'https://github.com/y5ez3g/facadecode/releases/latest/download/install.ps1'; & ([ScriptBlock]::Create([Text.Encoding]::UTF8.GetString($response.RawContentStream.ToArray())))

The installer adds facade and facade-mcp to PATH. Open a new terminal to use the updated PATH.

The IDE preview's launcher also uses the name facade. If both programs are installed, your shell runs the first facade on PATH. Run facade version and look for a line of the form facade <version> to verify that you have the Shell command. The launcher name belongs to the Orchestrator after the IDE preview is retired.

Run facade upgrade to install a newer version. Install and sign in to the CLIs you want to run on each machine. The built-in choices are Claude Code, Codex, Antigravity, Muse Code, OpenCode and Pi.

VS Code

code --install-extension facade.facadecode

The extension includes its own Orchestrator. Open Facade Code in the Activity Bar and choose New Agent, Go to Agent or Resume Agent. Packages are built for macOS, Linux and Windows on x64 and arm64. Marketplace · Open VSX · Extension guide

MCP

Add facade-mcp as a stdio MCP server in your app. This example uses an mcpServers object.

{
  "mcpServers": {
    "facade": { "command": "facade-mcp" }
  }
}

An external connection joins as a Guest on its first tool call. Send a message, then use the read_messages call returned by send_message to wait for its reply.

Work across machines

facade start --name ada -d codex
facade list
facade attach ada

Use the address printed by facade list. To work on another machine, register it with your usual SSH target and options. To reach WSL or a Dev Container from outside, start SSH inside that environment and register it the same way. You can also run Facade directly inside it.

facade machine add -p 2222 aaron@devbox.lan
facade start --machine devbox --folder /work/app --worktree feat-x claude

Facade installs the matching version on the remote machine when needed and runs it from its fixed installation path. If you need to install manually, use the same version as your local Orchestrator. In VS Code, Go to Agent can open the running agent's terminal. The workspace remembers the agents you open, their helpers and your Pins. Closing a terminal tab leaves the agent running. Resume Agent and facade resume offer saved work.

YOLO defaults to on. On connected machines, an agent with YOLO on can reach other agents across the network. Set "yolo": false in that machine's facade.json to keep the CLI's own approvals and sandbox and limit MCP reach to the caller's creation tree. The setting takes effect on start or resume. Run facade status to find the file.

Product documentation (中文) · Glossary

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 preview IDE installs alongside your editor with its own settings and extensions. 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

481 stars

Watchers

5 watching

Forks

Releases

Packages

Contributors

Languages