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 system script command. 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
script syntax and are handled explicitly.
Output Shape
Report:
- checkpoint;
- task ID and workspace;
- launcher status:
dry-run, scheduled, or blocked;
- 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.
1---2name: happy-handoff3description: Continue the current Codex Desktop task in Happy on Android when the user says "ухожу", asks to move or hand off to Happy, or invokes this skill explicitly.4license: MIT5---67# Happy Handoff89Resume 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.1011## Workflow12131. Finish the current tool call or other indivisible operation.142. Preserve the workspace. Do not clean, stash, commit, or rewrite dirty work for the handoff.153. Capture a compact checkpoint: completed work, current branch or directory, validation state, dirty files, active processes, and the next concrete step.164. Require `CODEX_THREAD_ID`, the current working directory, an authenticated Happy CLI, and the system `script` command. If a prerequisite is unavailable, report the exact blocker instead of opening an unrelated session.175. As the final tool action, run:1819 ```bash20 python3 "${CODEX_HOME:-$HOME/.codex}/skills/happy-handoff/scripts/launch.py"21 ```22236. 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.2425The 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.2627## Guardrails2829- Never add `--yolo`, bypass approval settings, or expand permissions.30- Do not claim that Android received the task until the user observes it there.31- Do not enable voice or daemon autostart as part of a handoff.32- Starting the Happy daemon when it is needed is allowed by the handoff request.33- Windows is currently unsupported; macOS and Linux use different `script` syntax and are handled explicitly.3435## Output Shape3637Report:3839- checkpoint;40- task ID and workspace;41- launcher status: `dry-run`, `scheduled`, or `blocked`;42- next step in Happy;43- unverified boundary: Android receipt until observed.4445## Provenance4647Original ABVX workflow around the MIT-licensed `slopus/happy` CLI. Happy is an external companion and is not bundled with this repository.