# 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 ↗](https://marketplace.visualstudio.com/items?itemName=facade.facadecode) or [Open VSX ↗](https://open-vsx.org/extension/facade/facadecode), 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.

| CLI | Command | Setup guide |
| --- | --- | --- |
| Claude Code | `claude` | [Claude Code quickstart ↗](https://code.claude.com/docs/en/quickstart) |
| Codex | `codex` | [Codex CLI ↗](https://developers.openai.com/codex/cli/) |
| Antigravity | `agy` | [Antigravity CLI installation ↗](https://antigravity.google/docs/install?tab=cli) |
| Muse Code | `muse` | [Muse Code setup ↗](https://dev.meta.ai/docs/muse-code) |
| OpenCode 2 | `opencode` | [OpenCode installation ↗](https://opencode.ai/docs/) |
| Pi | `pi` | [Pi quickstart ↗](https://pi.dev/docs/latest/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

- Open the **Facade Code** panel from the activity bar and choose **New Agent**.
- Check the working location and suggested agent name, then choose an installed CLI.
- In the terminal that opens, send a task for your project.

```text
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](https://facadecode.com/docs/permissions/) for details.

## Choose your next step

Use [Manage your agents](https://facadecode.com/docs/manage-agents/) to return to conversations, rename agents, or pin a useful session. Open [Agent settings](https://facadecode.com/docs/settings/) to change launch defaults or add another provider.

Ready to work with more than one agent? Try [a review loop](https://facadecode.com/docs/collaboration/implement-review/) on your own changes.