opencode-tui-status-indicatorOpenCode TUI plugin that shows agent status in the terminal tab title with an animated spinner
3
+1 in 30 days
29
6 in 7 days
32.6
Multi-signal model
2 months ago
2026-06-11
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-tui-status-indicator@1.0.3"]
}Writes to ~/.config/opencode/opencode.json — applies to every project.
~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-tui-status-indicator@1.0.3"]
}If you want to modify the plugin locally, install it into the project and reference the local path.
shell
pnpm add -D opencode-tui-status-indicatoropencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.
An OpenCode TUI plugin that shows agent status in the terminal tab title with an animated spinner.
Works on any terminal that supports OSC title sequences — Windows Terminal, iTerm2, WezTerm, Ghostty, Kitty, Alacritty, and more.
Status indicators
| State | Icon | When |
|---|---|---|
| Working | ⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏ |
Agent is processing (animated braille spinner) |
| Ready | ✓ |
Agent is idle |
| Error | ✗ |
Session error occurred |
| Waiting | ◉ |
Agent is waiting for user input (permission or question) |
The tab title also shows the current session name, e.g. ⠹ Fix auth middleware while working.
Install
opencode plugin opencode-tui-status-indicator --global
Restart OpenCode and the spinner will appear in your terminal tab.
How it works
This plugin uses OpenCode's TUI plugin API (renderer.setTerminalTitle()) to set the terminal tab title based on session events. Unlike plugins that write OSC escape sequences directly (which get captured by the TUI), this approach goes through OpenCode's renderer and works correctly on all platforms including Windows.
License
MIT