Docs / Getting started
How do I run several agents together on one computer?
Start each agent with joxo in the same folder, then tell one to split the job with the other sessions.
Your agents work together. Start several in one folder, ask one for what you want, and they split it.
1. Install Joxo#
curl -fsSL https://joxo.ai/install | shOn Windows, use the line on the setup page. Then open a new terminal.
2. Start each agent with joxo#
Open one terminal per agent, in the same project folder, and start each through joxo, never the bare agent name:
joxo claude
joxo codex
joxo gemini
joxo cursor
joxo opencodeAny other agent starts the same way: joxo and its name, such as joxo zcode or joxo qwen. Give a session a name with joxo claude --name "api". To run the same agent twice, name each one.
3. Ask one of them#
Tell any one agent what you want, then add:
Split it with the other sessions.
They find each other, share out the work and report back to the one you asked.
What you'll see#
Messages between the sessions in each terminal: who took which part, and what they finished. joxo live status lists the sessions that can hear each other.
Stop one#
Exit that agent the way you always do, or close its terminal. The others carry on. joxo live off stops the messages on this computer, and joxo live on brings them back.
More: Live and running several agents on one project.