Extension

patriceckhart/zot-notifier

A small zot extension that plays a notification sound when the assistant finishes a turn.

extension

Install from GitHub and zot copies the extension into $ZOT_HOME/extensions/. Git-installed extensions update with zot update.

shell
zot ext install https://github.com/patriceckhart/zot-notifier
repository
patriceckhart/zot-notifier
author
patriceckhart
stars
0
forks
0
open issues
0
language
Go
license
MIT
topics
zot-extension
created
May 16, 2026
updated
May 27, 2026

Security note: zot extensions can execute code. Review the source before installing third-party extensions.

Readme

zot-notifier

A small zot extension that plays a notification sound when the assistant finishes a turn. Handy for long-running tasks so you don't have to babysit the terminal.

Features

  • Plays a short "ding" via macOS afplay whenever a turn ends with a final reply.
  • Skips intermediate tool-use turns, errors, and aborts — only the real "done" moment triggers a sound.
  • Toggle on/off from inside zot via the /notifier slash command, which opens a small settings panel.
  • State persists to config.json next to the extension.

Requirements

  • macOS (uses the built-in afplay command).
  • Go 1.22+ on $PATH (the extension runs from source via go run ., no prebuilt binary is shipped). Install Go from https://go.dev/dl.
  • A working zot installation.

Install

zot ext install https://github.com/patriceckhart/zot-notifier

Or clone / copy this directory into your zot extensions folder. zot will pick it up automatically based on extension.json (it's enabled by default).

No prebuilt binary is shipped — extension.json runs go run ., so the first launch compiles main.go on the fly. Make sure go is on your $PATH.

Usage

  • Just run zot as usual — when a turn ends, you'll hear the ding.
  • Type /notifier to open the settings panel.
    • enter toggles the sound on/off.
    • esc closes the panel.

Files

File Purpose
extension.json zot extension manifest.
main.go Extension source.
ding.mp3 The notification sound.
config.json Persisted on/off state.

Credits

Sound Effect by Lesiakower from Pixabay

License

MIT