opencode-handoff

Create focused handoff prompts for continuing work in new sessions.

Inspired by Amp's handoff command - see their post and manual about it.

Features

- /handoff command that analyzes the conversation and generates a continuation prompt
- Guides the AI to include relevant @file references so the next session starts with context loaded
- Opens a new session with the prompt as an editable draft
- read_session tool for retrieving full conversation transcripts from previous sessions when the handoff summary isn't sufficient

Requirements

- OpenCode v1.0.143 or later

Installation

Add to your OpenCode config (~/.config/opencode/config.json):

``json
{
"plugin": ["opencode-handoff@0.3.2"]
}
`

Restart OpenCode and you're ready to go.

Pin to a specific version to ensure updates work correctly - OpenCode's lockfile won't re-resolve unpinned versions. To upgrade, change the version and restart.

$3

If you want to customize or contribute:

`bash
git clone https://github.com/joshuadavidthomas/opencode-handoff ~/.config/opencode/opencode-handoff
mkdir -p ~/.config/opencode/plugin
ln -sf ~/.config/opencode/opencode-handoff/src/plugin.ts ~/.config/opencode/plugin/handoff.ts
`

Usage

1. Have a conversation in OpenCode with some context
2. When ready to continue in a fresh session, type /handoff
3. A new session opens with the handoff prompt as an editable draft
4. Review and edit the draft if needed, then send

Example:

`
/handoff implement the user authentication feature we discussed
`

The AI analyzes the conversation, extracts key decisions and relevant files, generates a focused prompt, and creates a new session with that prompt ready to edit.

$3

When you use /handoff, the generated prompt includes a session reference line:

`
Continuing work from session sess_01jxyz123. When you lack specific information you can use read_session to get it.
`

This gives the AI in the new session access to the read_session tool, which can fetch the full conversation transcript from the source session. If the handoff summary doesn't include something you need, just ask - the AI can look it up.

Example:

`
You: What were the specific error messages we saw earlier?
`

The AI will use read_session to retrieve details from the previous session that weren't included in the handoff summary.

Contributing

Contributions are welcome! Here's how to set up for development:

`bash
git clone https://github.com/joshuadavidthomas/opencode-handoff
cd opencode-handoff
bun install
`

Then symlink the plugin to your OpenCode config:

`bash
mkdir -p ~/.config/opencode/plugin
ln -sf "$(pwd)/src/plugin.ts" ~/.config/opencode/plugin/handoff.ts
`

License

opencode-handoff is licensed under the MIT license. See the LICENSE` file for more information.

---

opencode-handoff is not built by, or affiliated with, the OpenCode team.

OpenCode is ©2025 Anomaly.