Browse

promptring

Updated September 14, 2026

Overview / Description

promptring is an open-source AI developer notification tool that fires native desktop banners when your GitHub Copilot CLI agent finishes a task, needs your input, or hits a blocker. Instead of watching the terminal, you get a real Notification Center or toast banner the moment something happens, each one labeled with the terminal tab name and a one-line summary of what the agent did. It works across macOS, Windows, Linux, and WSL from one codebase, using native delivery per operating system: a signed notification app on macOS, a WinRT toast on Windows, notify-send on Linux, and an inline toast under WSL. The only hard dependency is python3, with OS-specific extras such as Xcode Command Line Tools on macOS or the notify-send binary on Linux. promptring hooks into the Copilot CLI's own lifecycle events, so alerts fire deterministically on finish, permission prompts, and input requests rather than relying on fragile terminal escape codes. It ships with a bundled chime you can mute with promptring --mute or swap for a custom sound via promptring --tring, and installs with a single command under ~/.copilot/promptring. The project is MIT licensed, free to use, and collects no telemetry and requires no account, making it a lightweight companion for developers who run long agent tasks and want to step away from the terminal.

Used For

Best for developers running GitHub Copilot CLI who want native desktop alerts when an agent finishes, needs input, or is blocked.

Pricing

Plan

Free

Free and open source (MIT License)

View pricing

Pros & Cons

Pros

  • Native OS banners on macOS, Windows, Linux, and WSL from a single codebase
  • Only hard dependency is python3, so it stays lightweight to install
  • Hooks into Copilot CLI lifecycle events (finish, permission prompt, input request) for deterministic alerts
  • MIT licensed, free, with no account and no telemetry
  • Notifications label the terminal tab and summarize the agent's action

Cons

  • Built specifically for GitHub Copilot CLI, not other AI coding agents
  • Requires OS-specific extras such as Xcode Command Line Tools on macOS or notify-send on Linux
  • Setup involves a one-line install script and restarting the Copilot CLI
  • No hosted dashboard or team features; it is a local, single-user utility

Questions & Answers

Alternatives

ntfy, Pushover, terminal-notifier, GitHub Copilot CLI hooks

Reviews & Ratings

0 reviews

5
0%
4
0%
3
0%
2
0%
1
0%

Sign in to rate and review promptring.

Sign in to review

No reviews yet. Be the first to review promptring!

Try promptring free