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-command setup

Install from npm and the OS-aware setup configures the notifier and Copilot CLI hooks automatically.

🪝

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

Install the official npm package. The installer detects macOS, Windows, Linux, or WSL automatically.

npm install -g promptring

Prerequisites: Node.js 18+ and Python 3. macOS also needs Xcode Command Line Tools; Linux/WSL needs notify-send for notification banners.

Everything installs under ~/.copilot/promptring. Restart your Copilot CLI session so the hook loads, then run promptring --check.

Alternative direct or source installation

# 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

# From source
git clone https://github.com/pratyansh-agrawal/promptring.git
cd promptring
./install.sh
# Windows: powershell -ExecutionPolicy Bypass -File install.ps1