# Agent Notifier Skill

Use this skill when a user wants timely notifications and progress updates from agentic development work while they are away from the terminal.

## Premise

Agent Notifier is the missing harness piece for agentic development: agents keep working, and humans get concise phone notifications for progress, failures, approvals, links, files, and completion.

## What to install

- A local .env.local containing AGENT_NOTIFIER_API_KEY and AGENT_NOTIFIER_PROJECT.
- GitHub Copilot CLI workspace hooks in .github/hooks/hooks.json.
- Claude Code project hooks in .claude/settings.json.
- The canonical hooks/agent_notifier_hook.py runner.
- A CLAUDE.md note telling future agents to keep the human updated.

## One-time setup

1. Ask the user to create an Agent Notifier account API key from https://notifier.aicrew.in/app.
2. Ask for the project name that should appear in notifications.
3. From the target repository root, run:

~~~bash
export AGENT_NOTIFIER_API_KEY="an_key_REPLACE_ME"
export AGENT_NOTIFIER_PROJECT="My Project"
curl -fsSL https://notifier.aicrew.in/install.sh | bash
~~~

The installer writes secrets only to .env.local, which should be gitignored. Never paste API keys into committed docs, source, PR comments, shell history examples, or issue comments.

## Agent behavior after install

- Send progress updates at task start, major milestones, blockers, and completion.
- Prefer concise notifications over noisy logs.
- Use high priority only when user input is needed or a run is blocked/failing.
- Attach URLs or proof files when they help the human review work quickly.
- Keep prompt/command detail mode off unless the repo owner explicitly opts in.

## Manual notification example

~~~bash
curl -sS -X POST https://notifier.aicrew.in/api/v1/messages \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $AGENT_NOTIFIER_API_KEY" \
  -d '{"project":"My Project","type":"progress","title":"Agent update","message":"Validation is running","priority":0}'
~~~

## Docs

- Install page: https://notifier.aicrew.in/install
- API docs: https://notifier.aicrew.in/api/docs
- Hook docs: https://notifier.aicrew.in/api/docs/hooks.md
- Message API: https://notifier.aicrew.in/api/docs/messages.md