What is promptring?
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.
What is promptring used for?
Best for developers running GitHub Copilot CLI who want native desktop alerts when an agent finishes, needs input, or is blocked.
How much does promptring cost?
Pros and 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 about promptring
What is promptring?
promptring is a free, open-source tool that sends native desktop notification banners when your GitHub Copilot CLI agent finishes a task, needs your input, or hits a blocker, so you don't have to keep watching the terminal.
Which platforms does promptring support?
promptring works on macOS, Windows, Linux, and WSL from one codebase, using a signed notification app on macOS, a WinRT toast on Windows, notify-send on Linux, and an inline toast under WSL.
What does promptring require to run?
The only hard dependency is python3. Depending on your OS you may also need Xcode Command Line Tools on macOS, the notify-send binary on Linux and WSL, or Python from python.org with PATH enabled on Windows.
Is promptring free?
Yes. promptring is released under the MIT License, is free to use, requires no account, and collects no telemetry.
Can I change or mute the notification sound?
Yes. promptring ships with a bundled chime that you can mute with promptring --mute or replace with a custom sound using promptring --tring.
What are the best alternatives to promptring?
Reviews
Sign in to rate and review promptring.
Sign in to reviewNo reviews yet. Be the first to review promptring!