v2.1.0

Highlights

Interactive mini sessions, now with handoff support. This release adds slash questions, session handoff, a runtime Continue/Copy toggle, retry, persisted preferences, and configurable read-only tools.

New features

• Slash questions: /mini <question> and /mini-fresh <question> open the overlay and ask immediately. Bare /mini and /mini-fresh still wait for input. Copied main-session context is used in main mode only.
• Session handoff: /mini-handoff [instructions] asks the model for a Markdown handoff document covering status, decisions, files and commands, verification, open questions, and next steps. The internal prompt is attached as a system instruction, so the overlay shows only your extra instructions, or Generate a handoff.
• Continue or copy: Shift+Enter continues in the main thread by queueing the mini transcript, or copies it through the terminal clipboard (OSC 52). Toggle the mode with alt+y while the overlay is open; the button label updates immediately and the choice is remembered.
• Copy handoff: handoff mode copies only the latest assistant document, without the prompts or earlier drafts.
• Retry: failed responses show a Retry action that re-sends the last question.
• Persisted preferences: the model, variant, thinking visibility, and continue mode survive restarts. Saved models and variants that are no longer available fall back to a usable default with a notice.
• Configurable read-only tools: the plugin-managed agent defaults to read, glob, grep, webfetch, and websearch. Set tools to narrow the list. An explicit empty list, or one that filters down to nothing, disables every tool.

Shortcut changes

• alt+c is a fallback for the same Continue, Copy, or Copy handoff action as Shift+Enter. The button hint now shows alt+c. Shift+Enter remains supported.
• Thinking visibility now defaults to alt+t and the Continue/Copy toggle to alt+y. Set toggleThinkingKeybind to "ctrl+t" and continueKeybind to "ctrl+y" to keep the previous shortcuts.
• Use alt+c if your terminal cannot distinguish Shift+Enter, for example older Windows Terminal versions over SSH. Empty Enter intentionally does nothing.

Improvements and fixes

• Handoff requests wait for their system instructions to attach; a failure keeps the overlay open so Retry can recover instead of generating an unrelated answer.
• After viewing a handoff, an explicit /mini command returns to a regular mini session instead of reusing the handoff conversation.
• Oversized copied context is clamped safely below the 256 KiB instruction limit. The system preamble and context delimiters are preserved, the oldest context is dropped first, and the newest messages are kept, including multibyte text.
• Model selection changes update the displayed model, variant, and context counter immediately, including across pending storage writes and external preference updates.
• Removed unused code and updated documentation, including local checkout instructions and troubleshooting.

Compatibility

• Requires OpenCode V2 (opencode >= 2). This release targets the 2.x plugin line.
• OpenCode V1 users should continue using opencode-mini-session@1.
• No configuration changes are required for existing V2 users, other than the new default thinking and continue-mode shortcuts noted above.

Thanks to @LucasInstra for the feature work in #26.

Full changelog: v2.0.1...v2.1.0