Skip to main content
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.
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.

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 so that “ask Research to check this” is clear.

Check it worked

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.