OpenCode Chat History Plugin

OpenCode server plugin that adds tools so the assistant can list sessions and search past chat messages (by substring).

Install

Add to opencode.json:

{
  "plugin": ["opencode-chat-history-plugin"]
}

To turn the plugin off without editing config:

export OPENCODE_DISABLE_CHAT_HISTORY_PLUGIN=1

Tools

| Tool | What it does | |------|----------------| | get_current_session_id | Returns the active session id for the current tool call. | | session_list | Lists sessions. Optional search_mode: LOCAL (default, current worktree), ALL_WORKTREES (every worktree in the same OpenCode project), or ENTIRE_MACHINE (all sessions in the local OpenCode database, may span other repos). Filters: title search, roots, limit, start. | | chat_history_search | Finds a pattern in message text (plain substring, not regex). Optional session; with search_mode LOCAL (default) it falls back to the active session. ALL_WORKTREES / ENTIRE_MACHINE scan multiple recent sessions unless session is set (then only that session). Tuning: max_hits, max_messages, max_sessions, max_messages_total, case_sensitive. |

ALL_WORKTREES is limited to one OpenCode project. ENTIRE_MACHINE can include sessions from unrelated projects on this machine; use only when you intend that broader scope. ENTIRE_MACHINE needs an OpenCode build that injects PluginInput.listSessionsGlobal (in-process Session.listGlobal, not HTTP); without it, those tool calls return a clear upgrade message.