@ratteeth1/opencode-session-managerOpenCode plugin for querying and managing session history
0
47
6 in 7 days
25.4
Multi-signal model
3 months ago
2026-05-16
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": ["@ratteeth1/opencode-session-manager@0.1.5"]
}Writes to ~/.config/opencode/opencode.json — applies to every project.
~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@ratteeth1/opencode-session-manager@0.1.5"]
}If you want to modify the plugin locally, install it into the project and reference the local path.
shell
pnpm add -D @ratteeth1/opencode-session-manageropencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.
OpenCode plugin for querying, reading, summarizing, and opening local OpenCode session history.
Features
- List sessions as a table or JSON.
- Summarize a session with message counts and the latest prompt/response.
- Read session messages with optional tool/message parts.
- Ask a running OpenCode TUI to open a specific session.
Installation
Install as a remote OpenCode plugin after the package is published to npm:
opencode plugin @ratteeth1/opencode-session-manager@latest
For global installation:
opencode plugin @ratteeth1/opencode-session-manager@latest --global
OpenCode resolves the plugin through the package ./server export.
Tools
session_list
Lists sessions from the current OpenCode instance.
Arguments:
format:"table"or"json"limit: maximum number of sessionssearch: optional title/id search string
session_summary
Summarizes one session.
Arguments:
sessionID: OpenCode session id such asses_...maxMessages: maximum number of messages to inspect
session_read
Reads one session.
Arguments:
sessionID: OpenCode session id such asses_...limit: maximum number of messages to renderincludeParts: include message/tool parts when available
session_open
Requests the current OpenCode TUI to select a session.
Arguments:
sessionID: OpenCode session id such asses_...
License
MIT