notify

Sends desktop notifications with status, tmux context, and terminal-focus actions.

1|Updated May 4, 2026
One-click install
npx skills add https://github.com/wesbragagt/nixos-config --skill notify-wesbragagt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notify
Source: https://github.com/wesbragagt/nixos-config/tree/main/home/skills/notify
Command: npx skills add https://github.com/wesbragagt/nixos-config --skill notify-wesbragagt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When an AI agent finishes a task, gets blocked, or needs your input, you may not notice unless you are watching the terminal. This Skill sends desktop notifications so you know immediately when attention is required. ## Core Features & Use Cases - Status-based notifications: Sends notifications labeled Done, Needs attention, or Blocked with a robot emoji and a short message. - Terminal focus action: Includes an Open terminal action that focuses the recorded tmux session, window, and pane, plus a Super+N shortcut to open the latest notification target. - Use Case: You start a long-running build and switch to another window. When the build finishes, the agent runs agent-notify with a Done status, and you click the notification to jump straight back to the correct tmux pane. ## Quick Start Ask the agent to notify you when its current task finishes or when it needs your input.

Frequently Asked Questions about notify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a desktop notification when a command finishes?

Run agent-notify with a status and message, such as agent-notify "Done" "Rebuild passed." The notification includes a robot emoji, the status, the tmux session and window name, and your message.

What statuses does the agent-notify command support?

It supports three statuses: Done for completed work, Needs attention when the user must review or approve something, and Blocked when the agent cannot continue without user action.

Does the notification work with tmux sessions?

Yes. When tmux is available, the notification records the session, window, and pane. Clicking the Open terminal action or pressing Super+N focuses that exact tmux location.

How do I open the latest notification target from the keyboard?

Press Super+N to open the most recent notification target. If tmux is available, this focuses the recorded session, window, and pane directly.

When should I use Blocked instead of Needs attention?

Use Blocked when the agent cannot make any progress without user action, such as a missing secret or approval. Use Needs attention when work can continue but the user should review, test, or answer something.