opencode-sessions-sidebarOpenCode TUI plugin displaying active sessions list in the sidebar
0
37
7 in 7 days
27.6
Multi-signal model
1 month ago
2026-07-06
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": ["opencode-sessions-sidebar@0.1.0"]
}Writes to ~/.config/opencode/opencode.json — applies to every project.
~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-sessions-sidebar@0.1.0"]
}If you want to modify the plugin locally, install it into the project and reference the local path.
shell
pnpm add -D opencode-sessions-sidebaropencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.
English | 简体中文
opencode-sessions-sidebar
OpenCode TUI plugin that displays the current project's active sessions list in the sidebar.
Features
- Sessions list: Shows up to 10 most recently updated sessions for the current project (configurable)
- Click to switch: Click any session in the list to navigate to it instantly
- Current session indicator: The active session is marked with a
▶prefix - Running indicator: Sessions currently generating show a braille spinner animation
- Project-scoped: Only shows sessions belonging to the current project directory
- Real-time updates: List refreshes automatically on
session.created/session.updated/session.deletedevents - Collapsible panel: Click the header to collapse/expand; state persists across restarts
- Slash commands:
/sessions-refreshand/sessions-countfor runtime configuration - Theme adaptive: Colors auto-desaturate from the current theme for a muted look
Install
Method 1: OpenCode command palette (recommended)
In OpenCode, press Ctrl + P, search for install plugin, and enter:
opencode-sessions-sidebar@latest
Method 2: Manual install
npm install -g opencode-sessions-sidebar@latest
Then create or edit ~/.config/opencode/tui.jsonc:
{
"$schema": "https://opencode.ai/tui.json",
"plugin": ["opencode-sessions-sidebar@latest"]
}
Restart OpenCode
Enter any session and the Sessions panel will appear in the sidebar.
Slash commands
| Command | Description |
|---|---|
/sessions-refresh |
Manually refresh the sessions list |
/sessions-count |
Set the maximum number of sessions to display (1-100) |
License
MIT