Ghostty Notify

v1.0.0Tools & Commands

opencode-ghostty-notify

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

Actively maintained

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

GitHub repo npm page Homepage

GitHub stars

Monthly installs

3 in 7 days

Composite scoreSCORE

16.9

Multi-signal model

Last commit

5 months ago

2026-02-23

Install and configure

opencode.json

Writes to this project's opencode.json — applies to this repository only.

opencode.json

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

Writes to ~/.config/opencode/opencode.json — applies to every project.

~/.config/opencode/opencode.json

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

opencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.

README.md

View original→

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