AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
SKILL verified MIT Self-run

Desktop Notify

skill-graysurf-agent-kit-desktop-notify · by graysurf

Send desktop notifications (macOS/Linux) with a project-title wrapper.

↗ Repository
— No reviews yet
0 installs
7 views
0.0% view→install

Install

$ agentstack add skill-graysurf-agent-kit-desktop-notify

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/skill-graysurf-agent-kit-desktop-notify)

Reliability & compatibility

✓ Security review passed
0 installs to date
— no reviews yet
○ Archived

Declared compatibility

Claude CodeClaude Desktop

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.

How agent discovery & health will work →
Are you the author of Desktop Notify? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

Desktop Notify

Contract

Prereqs:

  • bash available on PATH.
  • Notification backend:
  • macOS: terminal-notifier
  • Linux: notify-send

Inputs:

  • Message string (required) and --level info|success|warn|error.
  • Optional env: CODEX_DESKTOP_NOTIFY_ENABLED=false to disable; PROJECT_PATH for project title derivation.

Outputs:

  • A desktop notification (best-effort); silent no-op when disabled or backend missing.

Exit codes:

  • 0: success or no-op
  • non-zero: invalid usage or unexpected script/runtime failure

Failure modes:

  • Backend not installed (script no-ops by default).
  • Notifications disabled via CODEX_DESKTOP_NOTIFY_ENABLED=false.

Use this skill when you need to surface a short status update to the user via a desktop notification.

Prefer using the project wrapper (auto title) to avoid repeating title rules:

$AGENT_HOME/skills/tools/notifications/desktop-notify/scripts/project-notify.sh "your short message" --level success

If you need a custom title, call the notifier directly:

$AGENT_HOME/skills/tools/notifications/desktop-notify/scripts/desktop-notify.sh \
  --title "custom title" \
  --message "your short message" \
  --level info

Supported entrypoints for this skill are only:

  • scripts/project-notify.sh
  • scripts/desktop-notify.sh

Keep docs/examples pinned to those two paths so script regression + smoke coverage stays accurate.

Quick local sanity check:

test -x "$AGENT_HOME/skills/tools/notifications/desktop-notify/scripts/project-notify.sh"
test -x "$AGENT_HOME/skills/tools/notifications/desktop-notify/scripts/desktop-notify.sh"

Behavior

  • macOS: uses terminal-notifier when installed.
  • Linux: uses notify-send (libnotify) when installed.
  • Missing backend: silent no-op by default.

Environment

  • CODEX_DESKTOP_NOTIFY_ENABLED=false: disable notifications (default: enabled)
  • CODEX_DESKTOP_NOTIFY_HINTS_ENABLED=true: print a one-line install hint when backend is missing (default: disabled)
  • PROJECT_PATH: used by $AGENT_HOME/skills/tools/notifications/desktop-notify/scripts/project-notify.sh to derive the project title (fallback:

git root, then $PWD)

Install hints

  • macOS: brew install terminal-notifier
  • Linux (Debian/Ubuntu): sudo apt-get install libnotify-bin
  • Linux (Fedora): sudo dnf install libnotify

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet, be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Agent Skills