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. 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://joxo.ai/install | sh
    Windows · PowerShell or Command Prompt, in your project folder
    powershell -ExecutionPolicy Bypass -c "irm https://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"
  2. Open a new terminal

    Open a new terminal window when setup finishes, so your shell finds joxo.

  3. Start Codex with joxo codex, or trust the folder

    Pasted into Codex, or added with joxo agents add 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
  4. 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.

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.