Devin handoff
Spin off parallel cloud Devin sessions. Hand off a task to a fresh cloud Devin session that runs in the background — each gets its own VM with shell, browser, and full repo access — so you can fan out several sessions at once and keep working locally while they run. Use for parallel or long-running work and anything needing Devin's full environment: multi-file changes, running servers, CI work, browser automation, migrations, or large refactors. Also an API for reading and interacting with current sessions — given a session URL or ID, the check/poll commands return its PR, status, branch, and latest message.From its SKILL.md
npx -y skills add club-cog/devin-handoff --skill devin-handoffAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- reads credentialsReads from 1 credential source: `DEVIN_API_KEY`.
- runs commandsInstructs the agent to run 7 commands, including `scripts/devin-handoff.sh create` and 6 more.
SKILL.md
3.0 KB, 602 tokens by cl100k_base, as published. Nobody here has run it
Devin Handoff
Hand off a task to Devin. Devin gets its own VM with shell, browser, and full repo access. You get a URL to watch progress, or can poll until the session completes.
All scripts/devin-handoff.sh paths below are relative to this skill's
directory. If installed as a Claude Code or Codex plugin, use
"${CLAUDE_PLUGIN_ROOT}/.agents/skills/devin-handoff/scripts/devin-handoff.sh".
Prerequisites
DEVIN_API_KEYenv var (get one at https://app.devin.ai/settings/api-keys)curl,jqin PATHgit(optional, for auto-detecting repo/branch/diff)
When to use
- Task needs a running server, database, or Docker
- Task requires browser interaction (OAuth, screenshots, E2E tests)
- Task involves CI/CD pipelines or deployments
- Task is long-running and the user wants to continue locally
- You need parallel execution on a separate machine
Steps
1. Gather context
From the current working directory:
- Repo: Run
git remote get-url origin, extractowner/repo - Branch: Run
git rev-parse --abbrev-ref HEAD - Diff: Run
git diff HEAD(truncated to 100KB automatically) - Task: The user's request, concise and specific
- Context (optional): Summarize what you've learned — files examined, root cause hypotheses, partial fixes
2. Create the session
scripts/devin-handoff.sh create \
--task "Fix the auth timeout bug — update middleware to respect configured timeout" \
--context "Investigated src/auth/session.py and src/auth/middleware.py. Timeout is hardcoded at 30m in session.py:42."
The script auto-detects repo, branch, and diff. The --context flag is
optional but helps Devin start faster. All sessions are automatically
tagged with handoff.
3. Report the URL and poll
Tell the user the session URL. If they want to wait for completion, poll until the session finishes:
scripts/devin-handoff.sh poll SESSION_ID --interval 15
The poll command prints status updates and exits when Devin finishes. It also prints the PR URL if one was created.
4. Archive when done (optional)
Archive a session to clean it up from the sidebar:
scripts/devin-handoff.sh archive SESSION_ID --org-id ORG_ID
Or use --archive on poll to auto-archive when the session finishes:
scripts/devin-handoff.sh poll SESSION_ID --interval 15 --archive --org-id ORG_ID
What ships with it: 1 file
11.7 KB alongside SKILL.md, 1 of them executable
scripts/
- devin-handoff.shruns11.7 KB
Gives 0 of the 12 instructions most agent orchestration skills give in 602 tokens
Counted across 848 of the 1,300 authors here whose files we hold, read 2026-09-06
- Dispatch one agent per independent problem domainin 56 of 848, across 42 files
- Run full test suite after integrationin 55 of 848, across 42 files
- Verify fixes do not conflictin 40 of 848, across 32 files
- Review each summary when agents returnin 40 of 848, across 31 files
- Write a handoff document summarising the current conversationin 30 of 848, across 25 files
- Reference existing artifacts by path or URLin 26 of 848, across 24 files
- Give each agent a specific scopein 19 of 848, across 10 files
- Give each agent a clear goalin 19 of 848, across 10 files
- Include a suggested skills section in the documentin 18 of 848, across 16 files
- Tailor the doc to the user argumentsin 18 of 848, across 15 files
- Issue all subagent dispatches in the same responsein 17 of 848, across 11 files
- Use git worktrees for isolationin 17 of 848, across 8 files
Said here and by no other author read
- Gather context from the working directory
- Create the session using the handoff script
- Poll until the session finishes
- Archive the session when done
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.