Happy Handoff
Resume the same Codex task in Happy after reaching a safe checkpoint. The handoff request authorizes starting Happy for the current task. It does not authorize commits, pushes, deployments, destructive actions, or unrelated changes.
Workflow
Finish the current tool call or other indivisible operation.
Preserve the workspace. Do not clean, stash, commit, or rewrite dirty work for the handoff.
Capture a compact checkpoint: completed work, current branch or directory, validation state, dirty files, active processes, and the next concrete step.
Require
CODEX_THREAD_ID, the current working directory, an authenticated Happy CLI, and the systemscriptcommand. If a prerequisite is unavailable, report the exact blocker instead of opening an unrelated session.As the final tool action, run:
python3 "${CODEX_HOME:-$HOME/.codex}/skills/happy-handoff/scripts/launch.py"Immediately return the checkpoint so it is stored in the task before Happy resumes it. Say that the handoff is scheduled and ask the user to open Happy on Android.
The launcher waits briefly, then starts happy codex --resume for the exact task in the same directory. Use --dry-run to validate prerequisites without scheduling a session.
Guardrails
- Never add
--yolo, bypass approval settings, or expand permissions. - Do not claim that Android received the task until the user observes it there.
- Do not enable voice or daemon autostart as part of a handoff.
- Starting the Happy daemon when it is needed is allowed by the handoff request.
- Windows is currently unsupported; macOS and Linux use different
scriptsyntax and are handled explicitly.
Output Shape
Report:
- checkpoint;
- task ID and workspace;
- launcher status:
dry-run,scheduled, orblocked; - next step in Happy;
- unverified boundary: Android receipt until observed.
Provenance
Original ABVX workflow around the MIT-licensed slopus/happy CLI. Happy is an external companion and is not bundled with this repository.
