Tui Status Indicator

v1.0.3工具与命令

opencode-tui-status-indicator

OpenCode TUI plugin that shows agent status in the terminal tab title with an animated spinner

维护活跃

#opencode #opencode-plugin #tui #terminal #title #spinner

GitHub 仓库 npm 页面官方主页

GitHub 星标

近 30 天 +1

月装机量

近 7 天 6

综合评分SCORE

32.6

生态多维模型

快速安装与配置

opencode.json

写入当前项目的 opencode.json，只对这个仓库生效。

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-tui-status-indicator@1.0.3"]
}

写入 ~/.config/opencode/opencode.json，对所有项目生效。

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-tui-status-indicator@1.0.3"]
}

opencode 启动时会通过内嵌运行时自动加载 npm 依赖并缓存至本地目录，无需手动在全局环境执行安装。

README.md

查看原始文件→

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