Menu
Create, list, respond to, and manage notifications through the notification service. Use for alerts, inter-agent messaging, and actionable prompts.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Store, search, and manage shared knowledge through the memory service. Use for persisting information across agent sessions, semantic search over stored knowledge, and inter-agent knowledge sharing.
Browse, read, and author per-project knowledgebase documents through the knowledge service CLI. Use for creating, updating, listing, and reading markdown documents stored against a project, and reconciling DB rows against disk.
Cut a new agentd release. Suggests the next semver version from conventional commits (or accepts an explicit `x.y.z`), bumps the workspace version, regenerates the changelog with git-cliff, then commits, tags, and pushes the `v*` tag that triggers the Release workflow. Use when the user runs /release or asks to publish/cut/tag a new version.
Create a new GitHub plan issue with the "Plan: <title>" format, appropriate labels, and structured body. Use when the user wants to capture a high-level plan for future work.
Ask the human user a question during workflow execution and check for answers. Use for agent-to-human Q&A, collecting decisions, and reacting to human responses via ask_response workflow triggers.
Branch stacking and PR management with git-spice for the agentd project. Use when creating stacked branches, submitting PRs, syncing with upstream, resolving rebase conflicts, or navigating a branch stack.
| name | agent-notify |
| description | Create, list, respond to, and manage notifications through the notification service. Use for alerts, inter-agent messaging, and actionable prompts. |
Skill for interacting with the agentd notification service — a message bus for alerts, prompts, and inter-agent communication.
# Simple notification
agent notify create \
--title "Build complete" \
--message "All tests passed on main"
# With source and priority
agent notify create \
--source system \
--priority high \
--title "Deployment failed" \
--message "Error in production deploy pipeline"
# Actionable notification (requires a response)
agent notify create \
--title "Approve deployment?" \
--message "Release v1.2.3 is ready to deploy to production" \
--requires-response true
# Persistent notification (survives restarts)
agent notify create \
--lifetime persistent \
--title "Maintenance scheduled" \
--message "Database migration at 2am UTC"
# Ephemeral with expiry
agent notify create \
--lifetime ephemeral \
--expires-in 3600 \
--title "Cache warming" \
--message "Cache rebuild in progress"
system — generated by agentd servicesask — generated by the ask servicemonitor — generated by the monitor daemonhook — generated by git/shell hookslow — informational, non-urgentnormal — default priorityhigh — important, should be seen soonurgent — requires immediate attentionephemeral — auto-expires (use --expires-in for TTL in seconds)persistent — remains until explicitly dismissed or deleted# List all notifications
agent notify list
# Filter by status
agent notify list --status pending
agent notify list --status viewed
agent notify list --status dismissed
agent notify list --status responded
agent notify list --status expired
# Only actionable (requires response)
agent notify list --actionable true
# Get notification count and breakdown
agent notify count
# JSON output
agent notify list --json
# Get a specific notification
agent notify get <notification-id>
# Respond to an actionable notification
agent notify respond <notification-id> "Approved — go ahead with deploy"
agent notify delete <notification-id>
agent notify health