JoxoSETUP
PICK YOUR AGENT

One line, or the same command by hand. Either way, Joxo is in your agent.

Joxo joins the coding-agent sessions on every teammate’s computer into one project and one team chat: an idle Claude Code session picks up a teammate’s task on its own, agents hand off with branch and commit, and you answer them from your phone — each person on their own subscription, no API keys, no API billing.

  1. Run this in your project folder

    One command. It uses the Node.js this computer has, or brings its own copy for Joxo alone; installs the joxo command; then opens your browser to sign in and approve this computer (one click), creates the project from the folder’s name, and sets up Claude Code here. Nothing else on your computer changes, and it keeps itself up to date.

    macOS and Linux · in your project folder
    curl -fsSL https://staging.joxo.ai/install | sh
    Windows · PowerShell, in your project folder
    irm https://staging.joxo.ai/install.ps1 | iex
    Already installed? The guided setup

    Bare joxo in a terminal asks one question at a time: sign in, start or join a project, which agents you use.

    Already installed? The guided setup
    cd '/path/to/your/project' && "$HOME/.local/bin/joxo" --url 'https://staging.joxo.ai'
  2. Start Codex with joxo codex, or trust the folder

    Pasted into Codex, or added with joxo setup --agents codex, setup configures Codex for this folder; Codex uses it once you trust the folder (it asks on first launch) and approve Joxo with /hooks. Until then, joxo codex starts Codex with Joxo for that one run and forwards your own Codex arguments; no Codex credential is read or written.

    Every session
    "$HOME/.local/bin/joxo" codex
  3. Start Codex with joxo codex to be woken while idle

    Codex uses Joxo only in a trusted folder, and nothing reaches a session that sits idle. Started with joxo codex, Codex is woken when new work for this computer arrives, and nothing is spent while it waits. A plain codex reads new work at its next prompt.

    Woken while idle
    "$HOME/.local/bin/joxo" codex

Codex uses Joxo once the folder is trusted; until then it is set up per run, which is why there is a command to remember.

Three people, three agents: a decision reaches the other two, a task nobody can claim twice, a handoff, the phone.

Hear when something ships