Astro-Han

Opencode Bell — Development skill for Claude Code

Development community

OpenCode plugin: privacy-friendly terminal bell notifications.

How to install Opencode Bell

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Astro-Han/opencode-bell and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Opencode Bell does

OpenCode plugin: privacy-friendly terminal bell notifications.

Alternatives in Development

Privacy Policy — Draft privacy policies with GDPR compliance considerations 7.8k ★
Octofriend — An open-source coding helper 911 ★
Herdr Reviewr — Review your coding agent's diff in a terminal pane and send line comments back to Claude Code, Codex, OpenCode 823 ★

README

opencode-bell

Never miss an OpenCode prompt again.

Zero dependencies — single-file plugin
Privacy-friendly — no message content, no external commands, no network calls
Configurable — choose which events trigger the bell
Smart debounce — avoids bell spam for the same event type per session

Install

npm (recommended)

Add the plugin to `~/.config/opencode/opencode.json`:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-bell@0.3.0"]
}

Restart OpenCode. It will auto-install the package and cache it under `~/.cache/opencode/node_modules/`.

Local file

Copy `index.js` into `~/.config/opencode/plugins/` and restart OpenCode.

Configuration

Two environment variables control behavior:

Variable	Default	Description
`OPENCODE_BELL_EVENTS`	`permission.asked,question.asked,session.idle,session.error`	Comma-separated list of events that trigger the bell
`OPENCODE_BELL_OUTPUTS`	`bell`	Comma-separated output methods: `bell` and/or `osc`
`OPENCODE_BELL_DEBOUNCE`	`1200`	Minimum ms between repeated bells for the same event type and session. Must be >= 1; 0 or negative falls back to default

Example — bell only on permission requests, with a 5-second debounce:

export OPENCODE_BELL_EVENTS="permission.asked"
export OPENCODE_BELL_DEBOUNCE="5000"

Example — terminal notification plus bell, similar to Claude Code's `iterm2_with_bell` style:

export OPENCODE_BELL_OUTPUTS="bell,osc"

Supported Events

Event	Fires when
`permission.asked`	OpenCode needs approval to run a tool
`question.asked`	OpenCode asks the user a question
`session.idle`	A session completes and is waiting for input
`session.error`	A session encounters an error

How it works

The plugin writes the BEL character (`\x07`) to stdout by default. Your terminal emulator interprets it — typically as an audio beep, a visual flash, or a dock badge, depending