Devin Handoff

Hand off tasks to Devin from any coding agent or the command line. Set it up as a plugin or skill in Claude Code, Codex, Cursor, and more.

Create a Devin session, get a URL, optionally poll until it's done, archive when finished.

Quick Start

As a Claude Code plugin (1-click install)

Add the marketplace and install the plugin from inside Claude Code:

/plugin marketplace add club-cog/devin-handoff
/plugin install devin-handoff@cognition

Then set your API key (get one at https://app.devin.ai/settings/api-keys):

export DEVIN_API_KEY="your-key-here"

Run /devin-handoff:setup to verify everything is ready.

That's it — ask Claude Code to "hand this off to Devin."

As a Codex plugin

Same idea, from your terminal:

codex plugin marketplace add club-cog/devin-handoff
codex plugin add devin-handoff@cognition
export DEVIN_API_KEY="your-key-here"

Then ask Codex to "hand this off to Devin."

As an agent skill

Install it into your coding agent's skills folder so the agent can hand off tasks to Devin on its own:

git clone https://github.com/club-cog/devin-handoff.git

# Copy into your agent's skills directory — adjust the path for your agent
mkdir -p .your-agent/skills
cp -r devin-handoff/.agents/skills/devin-handoff/ .your-agent/skills/devin-handoff/

# Set your API key (get one at https://app.devin.ai/settings/api-keys)
export DEVIN_API_KEY="your-key-here"

Then ask your agent to "hand this off to Devin." See examples/ for per-platform setup guides (Claude Code, Cursor, Codex).

For agents that use AGENTS.md, append the guide:

cat devin-handoff/AGENTS.md >> your-repo/AGENTS.md

From the command line

# 1. Set your API key
export DEVIN_API_KEY="your-key-here"  # Get one at https://app.devin.ai/settings/api-keys

# 2. Create a session from any git repo
./devin-handoff/scripts/devin-handoff.sh create --task "Fix the flaky auth test in CI"
# → https://app.devin.ai/sessions/abc123

# 3. (Optional) Poll until it's done
./devin-handoff/scripts/devin-handoff.sh poll devin-abc123 --interval 15

How It Works

1. Gathers git context — repo slug, branch, uncommitted diff (truncated to 100KB)
2. Creates a Devin session — POST /sessions with your task + context
3. Prints the session URL — share it with the user
4. (Optional) Polls — GET /sessions/{id} every N seconds until Devin finishes

Devin gets its own VM with shell, browser, and full repo access. It clones the repo, checks out the branch, and starts working. All sessions are tagged with handoff.

How Context Reaches the Cloud Session

Devin starts in a fresh VM, so the script packages up what your local agent already knows and includes it in the session prompt:

• Repo and branch — detected from git remote and git rev-parse, so Devin clones the right repo and checks out the branch you're on
• Uncommitted changes — the output of git diff HEAD (truncated to 100KB) is included, so your work-in-progress carries over instead of being lost on the way to the cloud. If you have local edits you don't want sent, commit or stash them before creating the session.
• --context — whatever the calling agent has learned so far: files it examined, root-cause hypotheses, partial fixes