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.
English · 简体中文 · 繁體中文 · Português (Brasil) · Español · Русский · Deutsch · 日本語 · Bahasa Indonesia · Français · 한국어 · Türkçe · Tiếng Việt · Polski
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.shRun 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.
code --install-extension facade.facadecodeThe 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
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.
facade start --name ada -d codex
facade list
facade attach adaUse 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 claudeFacade 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": falsein that machine'sfacade.jsonto 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. Runfacade statusto find the file.
Product documentation (中文) · Glossary
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/.
- Orchestrator and Shell. See
core/README.md. - Extension: Provide
extension/AGENTS.mdto your coding agent to build the package. - IDE: Provide
docs/ide/RELEASE.mdto your coding agent to build the application.
For contribution guidelines and branch discipline, see CONTRIBUTING.md and docs/ide/ENGINEERING.md.
- Bugs & ideas: GitHub Issues, or Help > Report Issue in the IDE.
- Security vulnerabilities: Please report privately according to
SECURITY.md.
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.
