Handoff

/handoff starts a boomerang-style worker session for the user’s requested goal, then returns a compact completion summary to the original session.

Usage

/handoff <what the worker should do>

The command asks the current orchestrator to call handoff_session with the worker prompt and any clearly relevant files.

Flow

The main session calls handoff_session.
Slim creates a real child session with parentID set to the main session.
The child runs as orchestrator, so it can use the normal specialist-agent workflow and delegate through task when useful.
Referenced files are loaded into the child as synthetic Read-tool context.
When the child finishes, Slim extracts its assistant output and returns it to the main session inside <handoff_summary>.
The child session is aborted for cleanup after the summary is extracted.

In tmux or zellij, the child appears like other delegated work because it is a real child session. Existing session-depth and pane cleanup handling apply.

What to put in the prompt

The user prompt controls scope. Keep it direct:

/handoff finish the docs for handoff and run the relevant checks
/handoff investigate the flaky auth test and report what changed
/handoff implement the small UI polish we discussed

The handoff prompt intentionally avoids prescribing extra actions. It should do what the user asks, then summarize what happened, files changed, validation run, and any remaining risks or follow-up.

Tools

Tool	Purpose
`handoff_session`	Creates the child worker session and returns its summary
`read_session`	Lets a handoff worker read details from the parent/source session

Safety

Nested handoffs are blocked: a handoff worker should finish its current task and return a summary instead of spawning another handoff worker.
File context is restricted to the workspace real path, including symlink checks.
Binary files are skipped.
Large files are capped before being injected as context.
Child sessions use normal OpenCode session lifecycle events, so multiplexer cleanup remains consistent with other delegated agents.

handoff.md 2.2 KB History Raw