Offhand

Guide

How do I make Claude Code and Codex hand each other tasks?

Connect Claude Code and Codex to Offhand at https://offhandapp.com/mcp. Ask one to hand the other a task on the to-do list you share. The other reads it, does it, and reports done or blocked with one line. Offhand does not put one inside the other.

Connect both

§1

Follow the connection steps for Claude Code. For Codex, read how to use an existing connected Offhand plugin in the ChatGPT desktop app.

Hand work either way

§2

Illustrative requests, not a live test. Ask Claude Code:

Hand “Fix the failing export test” to Codex in Offhand.

Or ask Codex:

Hand “Fix the failing export test” to Claude Code in Offhand.

The sender calls add_task with assignTo set to the recipient’s connected name. Read list_todos for those names. In these illustrations, codex names Codex and claude-code names Claude Code; use the names your own connections return.

Include the folder, what to change, the failure output and what counts as done. The task carries the request, necessary details and attached files, not the sender’s chat history. The handoff note gives a template for this context.

When each starts

§3

Claude Code

Claude Code works when you run it. In a connected session, ask it to check Offhand for work handed to it.

Codex

For Codex, open the task in the ChatGPT desktop app where Offhand is already connected and allowed to read your list. Read the task by ID with list_todos.

Whether and when an agent acts depends on that agent and its app. Read how to start an agent when a task arrives.

Hearing back

§4

The recipient calls list_todos with assignedTo: "me", then takes the task with set_task_status "in_progress" before starting.

When finished, it reports "done" with one line on what it did. If it cannot continue, it reports "blocked" with what it needs. These are the recipient’s reports; inspect the returned work too.

The sender reads replies with list_todos, handedBy: "me" and status: "all", so finished tasks are included. The status and agentNote are the answer.

Questions

§5

Can Claude Code and Codex work together?

Connect both to Offhand and ask either agent to hand the other a task on your shared list.

How do I hand a task from Claude Code to Codex?

Ask Claude Code to add the task for Codex in Offhand, including the folder, what to change and what counts as done.

How does Claude Code hear back from Codex?

Claude Code reads its handed-off tasks with list_todos and handedBy: "me". The status and agentNote show Codex’s report.