@alxark/opencode-panel-apps

An OpenCode TUI plugin that renders a sidebar panel showing the output of one or more shell commands, refreshed on a configurable interval.

Install

npm install @alxark/opencode-panel-apps

Then add the plugin to your OpenCode configuration (opencode.json or equivalent):

{
  "plugin": ["@alxark/opencode-panel-apps"]
}

Configuration

Create opencode-panel-apps.jsonc in your OpenCode config directory (the plugin reads OPENCODE_CONFIG_DIR first, otherwise the directory containing your active OpenCode config file):

{
  "apps": [
    {
      "icon": "git",
      "command": ["git", "rev-parse", "--abbrev-ref", "HEAD"],
      "period": 5000
    },
    {
      "icon": "load",
      "command": [ "uptime" ],
      "period": 10000
    }
  ]
}

Each entry takes:

Field	Type	Notes
icon	string	Required. Short label rendered before the output line.
command	string[]	Required. argv-style — first element is the binary, rest are args.
period	number	Optional. Refresh interval in ms. Default 10000, minimum 1000.

Behavior

• The command runs without a shell (shell: false); use sh -c "…" if you need pipes or globs.
• Each invocation has a timeout of 80 % of period, capped at 5000 ms.
• The first non-empty line of stdout is shown; if stdout is empty, stderr is used; otherwise ok. Output is trimmed to 80 characters.
• On non-zero exit or timeout the entry is rendered in the theme's error colour with an error: … prefix.
• A missing or invalid opencode-panel-apps.jsonc shows a single ⚠ - <reason> line.

License

MIT — see LICENSE.