@npv12/opencode-recapOpenCode TUI sidebar plugin for session recap generation
0
46
8 in 7 days
28.3
Multi-signal model
1 month ago
2026-07-09
Install and configure
opencode.jsonWrites to this project's opencode.json — applies to this repository only.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@npv12/opencode-recap@0.3.0"]
}Writes to ~/.config/opencode/opencode.json — applies to every project.
~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@npv12/opencode-recap@0.3.0"]
}If you want to modify the plugin locally, install it into the project and reference the local path.
shell
pnpm add -D @npv12/opencode-recapopencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.
OpenCode TUI sidebar plugin that generates a short Markdown session recap on demand.
Features
- Auto-generates a recap every 5 messages
- Recap is discarded after 5 more messages (10-message cycle)
- Click Recap in the sidebar to manually trigger generation
- Stays in the sidebar (does not pollute the chat thread)
- Uses the most recent 10 messages as recap context
- Creates a short-lived throwaway session for generation
Installation
opencode plugin add @npv12/opencode-recap
Or add to your opencode.json:
{
"plugins": {
"@npv12/opencode-recap": {}
}
}
Model Selection
By default, recap uses opencode/deepseek-v4-flash-free.
You can override it by setting both providerID and modelID:
{
"plugins": {
"@npv12/opencode-recap": {
"providerID": "github-copilot",
"modelID": "gemini-3-flash-preview"
}
}
}
Attribution
This plugin is adapted from streetturtle's recap plugin in the opencode-better-sidebar repository.
License
MIT