Repolode
Submit
shanselman

shanselman/toasty

A tiny Windows CLI that shows toast notifications and can hook into AI coding agents to alert you when their tasks finish.

View on GitHub
Stars
441
Forks
25
Open issues
12
Last commit
25 days ago

What is it?

Toasty is a small command-line tool for Windows that displays toast notifications from the terminal. Running a single command with a message and optional title shows a notification, and the tool registers itself automatically on first run.

Its main purpose is to alert developers when long-running work finishes inside AI coding agents. Toasty can install hooks for Claude Code, GitHub Copilot, Gemini CLI, and OpenAI Codex, and it applies a matching icon and title when it detects that it was called from one of these tools. The hooks can be removed again with a single uninstall command.

Optionally, setting an environment variable sends each notification as a push to a phone through ntfy.sh or a self-hosted ntfy server. The project is written in C++ with no dependencies and is built with CMake and Visual Studio 2022.

Key features

  • 01Shows Windows toast notifications from the command line with a custom title.
  • 02Installs and removes notification hooks for Claude Code, GitHub Copilot, Gemini CLI, and OpenAI Codex.
  • 03Auto-detects the calling AI CLI and applies its icon and title.
  • 04Sends optional push notifications to phones via ntfy.sh or a self-hosted ntfy server.
  • 05Checks for new releases once a day without auto-updating.

Use cases

  • Getting a desktop alert when Claude Code or Copilot finishes a long task.
  • Receiving a phone push when an AI agent completes work while away from the desk.
  • Adding Windows notifications to build or script output from any CLI tool.

Quick start

  1. 1

    Build the project with CMake

    cmake -S . -B build -G "Visual Studio 17 2022" -A x64
  2. 2

    Compile the Release build

    cmake --build build --config Release
  3. 3

    Send your first notification

    toasty "Hello World" -t "Toasty"

Things to know

  • Windows only; it relies on Windows toast notifications.
  • Building requires Visual Studio 2022 with the C++ workload.

Topics

#windows#cli#notifications#ai-agents#claude-code#cpp#toast

FAQ

What is toasty?
A tiny Windows CLI that shows toast notifications and can hook into AI coding agents to alert you when their tasks finish. Toasty is a small command-line tool for Windows that displays toast notifications from the terminal. Running a single command with a message and optional title shows a notification, and the tool registers itself automatically on first run.
Is toasty free to use? What license does it have?
toasty is open source under the MIT license. Check the license terms before using it in commercial products.
Is toasty still maintained?
Actively maintained. The last commit to toasty was on Sep 25, 2026.
What can I use toasty for?
Getting a desktop alert when Claude Code or Copilot finishes a long task. Receiving a phone push when an AI agent completes work while away from the desk. Adding Windows notifications to build or script output from any CLI tool.
How do I install toasty?
Build the project with CMake: cmake -S . -B build -G "Visual Studio 17 2022" -A x64 Compile the Release build: cmake --build build --config Release Send your first notification: toasty "Hello World" -t "Toasty"
Where can I get toasty?
The source code and installation instructions are on GitHub: https://github.com/shanselman/toasty

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects