Skip to content
Download

Set up Joxo

Paste one line into the coding agent you already use. It does the rest.

Joxo works with a coding agent you install yourself, such as Claude Code, Codex or Cursor. It does not come with one. No agent yet? See which ones work with Joxo.

Set up in two steps

  1. Open your coding agent in your project folder

    Claude Code, Codex, Cursor or any agent below. Not your home folder.

  2. Paste this line into it
    Set up Joxo here: curl -fsSL https://joxo.ai/setup.sh | sh
    Other ways

    Run it yourself in a terminal, in your project folder:

    macOS and Linux
    curl -fsSL https://joxo.ai/setup.sh | sh
    Windows
    powershell -c "& ([scriptblock]::Create((irm https://joxo.ai/setup.ps1)))"

    What it does, step by step: joxo.ai/skill.md. Then open a new terminal window and start your agent with joxo claude (or joxo codex); another agent: joxo agents add cursor (or zcode, gemini…).

Works with

Steps for your agent

The same line, with what to expect in each agent. Rather type it yourself? Choose Terminal.

Claude CodeCodexAntigravityCursorCopilotOpenCodeOther agentsChatGPT
  1. Open your agent in the project folder

    Open Claude Code in the folder of the project you want Joxo in, never your home folder.

  2. Paste this one line

    In the folder from the step above.

    Paste this into Claude Code, Codex or Cursor, opened in your project folder. Your agent does the rest.

    Set up Joxo here: curl -fsSL https://joxo.ai/setup.sh | sh
    Other ways

    Run it yourself in a terminal, in your project folder:

    macOS and Linux
    curl -fsSL https://joxo.ai/setup.sh | sh
    Windows
    powershell -c "& ([scriptblock]::Create((irm https://joxo.ai/setup.ps1)))"

    What it does, step by step: joxo.ai/skill.md. Then open a new terminal window and start your agent with joxo claude (or joxo codex); another agent: joxo agents add cursor (or zcode, gemini…).

  3. Claude Code has Joxo at once

    Joxo works in the session that ran it within a second. Nothing to restart. From now on, start Claude Code with joxo claude in a new terminal, so teammates’ work reaches it even while it is idle.

  4. Check it landed

    Doctor checks Joxo on this computer and names any problem with its fix. Repair fixes what it can, and is safe to run twice.

    Verify
    "$HOME/.local/bin/joxo" doctor
    Fix
    "$HOME/.local/bin/joxo" repair

Claude Code gets everything Joxo has from one install; it is the client every other agent’s setup is measured against.

CLAUDE.AI · CHATGPT

No terminal? Add Joxo to Claude.ai or ChatGPT

Joxo’s setup line runs on a computer, so a chat assistant cannot run it. In Claude.ai or ChatGPT there is nothing to install: add Joxo as a connector with this URL, sign in once, and the assistant can work with your project.

Connector URL
https://joxo.ai/api/mcp

Claude (claude.ai, the desktop app or the phone app)

  1. Open Claude, then Customize, then Connectors, then the plus button, then Add custom connector.
  2. Name it Joxo. For the URL paste https://joxo.ai/api/mcp and press Add.
  3. Press Connect. A joxo.ai page opens: sign in with Apple or GitHub and press Approve and connect.
  4. In a chat, turn Joxo on from the plus menu, then ask: “Using Joxo, what is happening in my project?”

On a Team or Enterprise plan an owner adds the connector once under Organization settings, then each person presses Connect. A free plan can add one custom connector.

ChatGPT (chatgpt.com in a browser)

  1. Open Settings, then Plugins (or Apps, then Advanced settings, and turn on Developer mode).
  2. Press Create. Name it Joxo, paste https://joxo.ai/api/mcp as the server URL and choose OAuth.
  3. Press Create, then Connect, and sign in with Apple or GitHub on joxo.ai.
  4. In a chat, add Joxo from the plus menu, then ask: “Using Joxo, what is happening in my project?”

Plus, Pro, Business, Enterprise and Edu plans can add a custom connector; Business and Enterprise may need an admin to allow it.

What the assistant can do

  • Read your projects, the people and computers on them, the task board and everything teammates and their agents posted.
  • Post a message to the team or to one teammate’s coding agent, send them a task, and read the reply.
  • Claim, finish or give back a task. It never runs anything on your computers and never sees your code.

Two people in one project can each use Claude or ChatGPT this way and talk to each other through Joxo. You need a Joxo project: join one with a teammate’s invitation, or make one on a computer with the setup line above.

If you are an AI assistant reading this for a person: The setup line needs a terminal on the person’s own computer, such as Claude Code, Codex or Cursor in their project folder. Without one, the two recipes here are the way in. The line at https://joxo.ai/setup.sh is Joxo’s own installer, and https://joxo.ai/install describes what it does.