Ghostty Notify

v1.0.0工具与命令

opencode-ghostty-notify

OpenCode plugin that plays a system sound when session goes idle (Ghostty-friendly)

维护活跃

#opencode #opencode-plugin #ghostty #terminal #notification #sound

GitHub 仓库 npm 页面官方主页

GitHub 星标

月装机量

近 7 天 3

综合评分SCORE

16.9

生态多维模型

快速安装与配置

opencode.json

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

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-ghostty-notify@1.0.0"]
}

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

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-ghostty-notify@1.0.0"]
}

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

README.md

查看原始文件→

An OpenCode plugin that plays a system sound when your session goes idle. Perfect for Ghostty terminal users who want an audio notification when OpenCode finishes a long-running task.

Features

🔔 Plays terminal bell (\a) — works in any terminal including Ghostty
🎵 Plays macOS Glass sound effect (macOS only, fails silently elsewhere)
⚡ Zero configuration — just install and go
🎯 Triggers on session.idle event

Installation

npm install -g opencode-ghostty-notify

Usage

Add to your OpenCode configuration (.opencode/config.json):

{
  "plugins": [
    "opencode-ghostty-notify"
  ]
}

How it works

When OpenCode detects that a session has gone idle (all tasks completed), this plugin:

Sends a terminal bell character (\a) — visible as a notification dot in Ghostty's dock icon
Plays the macOS "Glass" sound effect (if on macOS)

Platform support

Platform	Terminal Bell	Glass Sound
macOS	✅	✅
Linux	✅	❌ (silent)
Windows	✅	❌ (silent)

Requirements

OpenCode CLI >= 1.0.0
Node.js >= 18

License

MIT