Facade Code Docs
Get started

Run your first agent

Install Facade Code, connect a CLI to your account, and give an agent a task in your project.

1. Install Facade Code

Install the extension from the VS Code Marketplace ↗ or Open VSX ↗, then open your project folder in the editor.

Installing Facade Code also adds Facade Code Window Component, a companion extension that connects your Facade projects.

2. Set up a CLI

Install at least one of the CLIs below and complete its login or provider setup. Open it in your project’s integrated terminal and confirm it can answer a short request before starting it through Facade.

CLICommandSetup guide
Claude CodeclaudeClaude Code quickstart ↗
CodexcodexCodex CLI ↗
AntigravityagyAntigravity CLI installation ↗
Muse CodemuseMuse Code setup ↗
OpenCode 2opencodeOpenCode installation ↗
PipiPi quickstart ↗

Facade requires OpenCode 2 (@opencode/cli), rather than the older opencode-ai package. For remote projects, install and authenticate the CLI on the machine where the project runs.

3. Give an agent its first task

  1. Open the Facade Code panel from the activity bar and choose New Agent.
  2. Check the working location and suggested agent name, then choose an installed CLI.
  3. In the terminal that opens, send a task for your project.
A first task
Read this project and explain how to run its checks.

New agents start with YOLO on. That tells the CLI to skip approval prompts where supported, and lets the agent contact your other Facade agents. To turn it off, open facade.json (Open Settings → Facade: Home → Edit in facade.json) and set "yolo": false at the top level. See Approvals and agent access for details.

Choose your next step

Use Manage your agents to return to conversations, rename agents, or pin a useful session. Open Agent settings to change launch defaults or add another provider.

Ready to work with more than one agent? Try a review loop on your own changes.

View as Markdown ↗Docs

Search the docs

Search this guide. Use ↑ ↓ to move, Enter to open, Esc to close.