Repolode
Submit
mustafaerpek

mustafaerpek/opencode-brief

An OpenCode plugin that turns a session's tool calls, shell commands and diffs into a reviewable Markdown handoff brief.

View on GitHubWebsite
Stars
0
Forks
0
Open issues
0
Last commit
11 days ago

What is it?

opencode-brief is a community plugin for OpenCode that builds a handoff brief from an existing session. Long sessions accumulate useful evidence in tool calls, shell commands and diffs; the plugin collects that evidence into one Markdown document that can be pasted into a pull request, saved as HANDOFF.md, or used to start the next session.

The brief is generated deterministically and does not call a model or make external network requests. It covers the first and latest user requests, changed working-tree files with line counts, non-test shell commands, test, typecheck and lint results with exit status, tool activity, the last assistant message, and open questions such as TODOs in the diff.

It is available in the OpenCode Desktop side panel and as the terminal /handoff command. Briefs are cached with a staleness check, and the template supports English and Turkish headings. Quoted session text is kept in its original language.

Key features

  • 01Generates a Markdown handoff brief from an OpenCode session without calling a model.
  • 02Lists changed files with line counts and status from the working tree.
  • 03Records shell commands and test, typecheck and lint results with exit codes.
  • 04Shows a composer pill when the session has changed since the cached brief.
  • 05Offers Copy, Save and Insert actions in the Desktop panel and save-to-HANDOFF.md in the terminal.

Use cases

  • Pasting a summary of an agent session into a pull request description.
  • Handing off unfinished work to another developer or a fresh OpenCode session.
  • Reviewing which files, commands and verifications an AI coding session produced.

Quick start

  1. 1

    Install the plugin into OpenCode

    opencode plugin add opencode-brief
  2. 2

    Or add opencode-brief to the plugins list in your global opencode.jsonc

  3. 3

    Restart OpenCode Desktop after the install, or start a new CLI session

  4. 4

    Run /handoff in a session to open the Brief panel

Things to know

  • Requires OpenCode 2.2 or later.
  • The Desktop GUI API is experimental and can change between releases.
  • This is a community plugin, not an official OpenCode project.
  • The brief quotes session text, including prompts, file paths and commands, so review it before sharing.

In collections

AI coding assistants & agentsStatic site generators & documentation tools

Topics

#opencode#developer-tools#handoff#markdown#ai-coding#plugin#opencode-plugin

FAQ

What is opencode-brief?
An OpenCode plugin that turns a session's tool calls, shell commands and diffs into a reviewable Markdown handoff brief. opencode-brief is a community plugin for OpenCode that builds a handoff brief from an existing session. Long sessions accumulate useful evidence in tool calls, shell commands and diffs; the plugin collects that evidence into one Markdown document that can be pasted into a pull request, saved as HANDOFF.md, or used to start the next session.
Is opencode-brief free to use? What license does it have?
opencode-brief is open source under the MIT license. Check the license terms before using it in commercial products.
Is opencode-brief still maintained?
Actively maintained. The last commit to opencode-brief was on Oct 27, 2026.
What can I use opencode-brief for?
Pasting a summary of an agent session into a pull request description. Handing off unfinished work to another developer or a fresh OpenCode session. Reviewing which files, commands and verifications an AI coding session produced.
How do I install opencode-brief?
Install the plugin into OpenCode: opencode plugin add opencode-brief Or add opencode-brief to the plugins list in your global opencode.jsonc Restart OpenCode Desktop after the install, or start a new CLI session Run /handoff in a session to open the Brief panel
Where can I get opencode-brief?
The source code and installation instructions are on GitHub: https://github.com/mustafaerpek/opencode-brief

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects