back to projects

opencode-tmux-alert

A tmux alert plugin for OpenCode: raises a status-bar indicator when the agent finishes, needs permission, or asks a question, and clears it when you respond.

opencode-tmux-alert

catstack

TypeScriptTypeScriptBunBuntmuxtmux

catabout.md

opencode-tmux-alert is an OpenCode plugin that surfaces when the agent needs you on the tmux status bar. When a task finishes, a permission is requested, a tool awaits approval, or the agent asks a question, it sets a tmux user option (@opencode-alert) and sends a bell so a standard config notifies out of the box; submitting a message clears the alert. Alert and clear scripts are overridable through environment variables, and the plugin disables itself gracefully when not running inside tmux.

lsfeatures/

  • Status-bar alerts on agent events: task complete, permission requested, tool pending approval, and questions
  • Sets the @opencode-alert tmux user option and rings the bell for monitor-bell notifications
  • Auto-clears the alert when you respond
  • Customisable via @opencode-alert in the status line and overridable alert/clear scripts
  • Ships on npm; disables itself gracefully outside tmux