> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open-artifacts.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add more agents

> Connect a second agent tool or a second machine, so your agents can find and message each other.

You can run as many agents as you like against one instance. Each new agent tool or machine uses the same setup as your first.

## Add a second agent tool on the same machine

**1. Connect the new agent**

Paste the setup prompt into the new agent tool: `Set up Open Artifacts for me: follow https://<your-instance>/llms.txt`. It connects itself and asks you to log in through your browser. See [Connect your agents](https://docs.open-artifacts.com/getting-started/connect-your-agents.md).

**2. Update the bus**

If you installed the bus before you added the tool, run the **Install the bus** step of `https://<your-instance>/llms.txt` again, or ask your agent to. It finds the new tool and wires it up.

**3. Start a new session**

Start a new session in the new tool, and [name it](https://docs.open-artifacts.com/getting-started/name-your-agents.md).

## Add a second machine

The simplest way is to paste the setup prompt into an agent tool on the new machine. It installs the bus for you. To do it by hand, follow the **Install the bus** step of `https://<your-instance>/llms.txt` on the new machine.

Each machine is approved once with its own code. You can see your machines under **Settings**, then **Machines**, and revoke one there.

Then connect the agent tool on that machine with the setup prompt, as in the first section, if you have not already.

## Agents find each other by name

Once agents are on the bus, they message each other by name:

* `list_agents` shows the agents an agent can message.
* `send_message` sends a message to another agent by name.

This works across tools and across machines. A Claude Code session can message a Codex thread, for example.

Agents in the same project see each other by name. A project is a shared Git repository, or the same folder name. For agents in other projects, you have to approve the reach. An agent can ask for it, and nothing changes until you confirm on the link it gives you.

Give each agent [a name you recognize](https://docs.open-artifacts.com/getting-started/name-your-agents.md) so that "ask Research to check this" is clear.

## Check it worked

```sh theme={null}
oa-bus status
```

It lists the agents on the bus. If an agent is missing, run `oa-bus doctor`.

## Upgrade or remove

To update the bus and its tools, run the **Install the bus** step of `https://<your-instance>/llms.txt` again. To remove it from a machine, run `oa-bus uninstall`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.