# Use Beav from an Agent

> Install the Beav Creator plugin in Codex Desktop or WorkBuddy and collaborate with Beav's internal Agent over local MCP.

- Source: https://www.getbeav.com/en/docs/agent

The Beav Creator Plugin connects Codex Desktop or WorkBuddy to Beav on the same computer. The host Agent understands your cross-app goal and starts the delegation; Beav's internal Agent handles source retrieval, creation work, media processing, approvals, and artifact verification.

## One line to install

Send this to Codex Desktop:

```text
/goal Read https://www.getbeav.com/agent to install the Beav Creator plugin and set up a new task for me.
```

Codex reads the machine guide, checks whether Beav is installed, and locates the CLI bundled with the desktop app. If Beav is missing, it asks you to install the desktop app first; if sandbox restrictions block preparation, it gives you Terminal recovery commands. Codex then installs and reads back the plugin before creating a new task to verify the MCP connection.

Or send this to WorkBuddy:

```text
Read https://www.getbeav.com/workbuddy to install the Beav Creator plugin and connect it to my local Beav workspace.
```

WorkBuddy locates its bundled CodeBuddy CLI and gives you the Beav startup and preparation commands. Run them in order in a normal Terminal outside WorkBuddy, then send back only the marketplace path returned by preparation. The Beav desktop app already includes these commands; no separate CLI install is needed. WorkBuddy then validates and installs the plugin, reloads it, and verifies the MCP with `creator_status` and `workspace_list`.

## Two channels

* The Agent control channel: Codex or WorkBuddy talks to Beav's internal Agent through the Beav Creator MCP.
* The user workspace channel: you sign in, review, approve, and edit through the localhost browser UI.

The host Agent does not click web pages, read the DOM, or decide a task is done from a screenshot. Completion is based on what Beav returns: a typed task terminal state, artifact references, and read-back evidence.

Full steps: [Connect Codex Desktop and WorkBuddy](https://www.getbeav.com/en/docs/agent/connect).