Why promptring?

The GitHub Copilot CLI gives you no reliable desktop notification when an agent finishes or pauses for input — so you sit and watch the terminal, or miss the moment entirely. promptring fixes that with real native banners that fire from any terminal — Terminal.app, iTerm2, VS Code, Windows Terminal, or tmux — identically on macOS, Windows, Linux and WSL. macOS is the reference design; every other OS gets the same banner through its own native delivery.

Features

🔔

Real macOS banners

A signed notification agent posts genuine Notification Center banners on macOS — not fragile escape codes — with native equivalents on Windows, Linux and WSL.

🌍

macOS · Windows · Linux · WSL

One Python orchestrator, native delivery per OS: a signed app on macOS, a WinRT toast on Windows, notify-send on Linux, and an inline toast under WSL.

📂

Tab name & summary

Each banner shows which terminal session pinged you and a one-line recap of what the agent did.

⚡

One dependency

Just python3 — no Homebrew, no package manager, no osascript hacks. Clone and run the installer.

🪝

Native CLI hooks

Fires on the Copilot CLI's own lifecycle events — finish, permission prompt, input request — so a banner shows up reliably without you watching the terminal.

🔊

Mute & custom tone

Ships its own “tring” chime, layered on the banner. From any terminal, promptring --mute silences it (banners stay) and promptring --tring <file> sets your own sound.

Install

One line, no clone. Everything installs under ~/.copilot/promptring — then restart your Copilot CLI session so the hook loads.

# macOS · Linux · WSL
curl -fsSL https://pratyansh-agrawal.github.io/promptring/install.sh | bash

# Windows (PowerShell)
irm https://pratyansh-agrawal.github.io/promptring/install.ps1 | iex

# test it
~/.copilot/promptring/bin/promptring.py done "promptring works"

Prerequisites: python3. macOS also needs Xcode Command Line Tools (xcode-select --install); Linux/WSL also needs notify-send (sudo apt install libnotify-bin); Windows needs Python from python.org ("Add to PATH"). Prefer to clone? git clone the repo and run ./install.sh (or install.ps1). Full per-OS docs on GitHub.