skills.rest
xuezhaojun
xuezhaojunCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

hook-session-notification

Send macOS and Linux desktop notifications for session completion or errors.

Updated Apr 12, 2026
Search Tags:#automation#workflow#monitoring#session#hook#notification#desktop-notifications
One-click install
npx skills add https://github.com/xuezhaojun/oh-your-opencode --skill hook-session-notification
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hook-session-notification
Source: https://github.com/xuezhaojun/oh-your-opencode/tree/main/.opencode/skills/hook-session-notification
Command: npx skills add https://github.com/xuezhaojun/oh-your-opencode --skill hook-session-notification

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Notifying users about session progress is often missed in busy workstreams. This hook provides desktop notifications when sessions complete or error, allowing teams to stay informed without watching logs constantly.

Core Features & Use Cases

  • Listens for session events and triggers OS-native notifications on macOS and Linux (Windows is not supported yet).
  • Supports configurable idle (completion) and error alerts, with an optional custom notification command.
  • Use Case: During long-running agent tasks, you receive a clear alert when a session finishes or fails, enabling faster follow-up.

Quick Start

Install the hook and enable session notifications in your workflow to start receiving alerts.

Frequently Asked Questions about hook-session-notification

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

FAQPage Schema
How do I get desktop notifications for long-running session completion or errors?▼

Desktop notifications for session events are triggered by a hook that sends OS-native alerts on macOS and Linux when tasks finish or fail. This allows you to stay informed without constantly watching logs.

Can I use session notifications to monitor agent tasks on Windows?▼

Session notifications do not work on Windows. The hook currently supports OS-native desktop notifications only on macOS and Linux environments for alerting on task completion or errors.

How do I configure session notifications to send custom alerts?▼

You configure session notifications by implementing the sessionNotification function exported from the hooks module. This function accepts configurable idle and error flags, along with an optional custom notification command.

What is the best way to automate alerts for idle and error states in a workflow?▼

Automating alerts for idle and error states involves a session hook that listens for workflow events and triggers desktop notifications. This mechanism keeps teams aware of task progress and failures during long-running processes.

Do I need to install dependencies to enable desktop notifications for session events?▼

No dependencies are required to enable desktop notifications for session events. The hook operates independently to send OS-native alerts directly within supported macOS and Linux environments.

Related Skills

Explore More Software Engineering Skills→
carlopezzutocarlopezzuto
3

prometheus-configuration

Configure Prometheus scrape configurations, recording rules, and alerting for Kubernetes and Docker.

Community
Advanced
alangebalangeb

tmux_monitoring

Monitor tmux sessions for process completion and status updates.

Community
Intermediate
stevolandstevoland

overseer

Coordinate long-running work with hierarchical milestones and tasks via the Overseer API.

Community
Intermediate
allthingslinuxallthingslinux
1

observability-monitoring-monitor-setup

Implement observability stacks with Prometheus, Grafana, OpenTelemetry, and Alertmanager.

Official
Advanced