Skip to content

Repository files navigation

Agent Alerts Agent Skills

skills.sh

Trusted, reviewable agent skills for sending Agent Alerts to iPhone through one hosted HTTPS webhook and one bundled script.

Start new setups at andreas.ink/agent. The connection flow creates a publish-only token for the runtime. For a hosted runtime, store it in that runtime's secret manager as AGENTALERTS_AGENT_TOKEN. For a local Mac setup, store exactly AGENTALERTS_AGENT_TOKEN=<token> in ~/.config/agent-alerts/token.env, set the file to mode 0600, and enter the token outside the agent conversation. Never paste the token into agent chat.

This repository publishes two skills:

  • $agent-alerts-setup designs and verifies an automation.
  • $agent-alerts-execution sends or skips an alert through agent-alerts-execution/scripts/send_webhook.sh.

The script validates the payload and secret configuration, uses the hosted endpoint by default, keeps the token out of process arguments, and preserves idempotency across a retry.

Install

npx skills add AndreasInk/AgentAlertsSkill

Or ask your agent:

Install https://github.com/AndreasInk/AgentAlertsSkill.
Use $agent-alerts-setup to configure my automation.
Use $agent-alerts-execution when it is time to send or skip.

These files follow Vercel's Agent Skills guidance: focused instructions, clear activation descriptions, and a deterministic bundled script. The public skills.sh directory surfaces GitHub-hosted skills from install activity and publishes security-audit information. Review skill files and scripts before installing or updating them.

Trust Model

  • One publish-only token per runtime.
  • One auditable HTTPS helper for every send.
  • No token in prompts, URLs, logs, source files, or command arguments.
  • Exact-script authorization for unattended runners.
  • Stable idempotency keys for retries.
  • Delivery counts reported without treating request acceptance as device-visible proof.

Live Activity Examples

Ops Calm Release Readiness Conversion Trend
Ops Calm Release Readiness Conversion Trend
Storefront Trend Service Errors Traffic Incident
Storefront Trend Service Errors Traffic Incident
Build Progress Launch Console Document Preview
Build Progress Launch Console Compact Console

More Info

Read the Agent Alerts docs or join the iOS TestFlight.

About

Agent skills for Codex/Claude to set up automations that send iPhone Live Activity, widget, notification, and Control Widget updates to your iPhone.

Topics

Resources

Stars

3 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages