opencode-session-tracker
v1.1.1
Published
OpenCode TUI plugin - list and switch between sessions in the sidebar
Maintainers
Readme
OpenCode Session Tracker
A lightweight and robust TUI plugin for OpenCode that brings real-time session tracking, subagent grouping, and status monitoring directly to your sidebar.
Managing multiple active sessions and navigating between different project agents can become difficult as workflows scale. opencode-session-tracker solves this by providing a clean, interactive tree-view, allowing you to instantly see what your agents are doing and switch contexts seamlessly.

Features
- Interactive Sidebar: Click on any session to instantly switch to it.
- Subagent Grouping: Subagents are neatly nested under their parent sessions like a folder tree. You can expand/collapse them by clicking the
[+]or[-]icons. - Smart Active Pop-out: Even if a parent session is collapsed, any subagent that is currently doing work (running, waiting, or asking for permission) will automatically pop out so you don't miss it!
- Real-Time Status Indicators:
[RUN](Green): Agent is actively running/generating.[IDLE](Gray): Agent is done and waiting.[WAIT](Yellow): Agent is retrying or waiting on an internal process.[ASK](Magenta): Agent is waiting for you to answer a question.[PERM](Magenta): Agent is waiting for your permission to run a command.
Installation
Run the official OpenCode plugin installation command:
opencode plugin opencode-session-tracker --globalRestart OpenCode!
Development
If you want to tweak this plugin yourself:
- Clone this repository.
- Run
npm installto grab the dependencies. - Edit
src/index.tsx. - Run
npm run buildto compile the TSX into thedistfolder. - Point your
tui.jsonto the absolute path of this cloned repo.
