Agent NotifierSimple setup

Optional add-on

Add live agent sessions after notifications work.

The session watcher is for power users who want Claude/Copilot hook timelines, approval cards, tool-call history, and a future session inbox. Notifications do not require this setup.

Confirm notifications work

Install notify.py, save an API key, and send one test notification before adding hooks.

bash
~/bin/notify.py "Session watcher preflight from $(hostname)" --type progress

Install watcher hooks

Run the hook installer from the repo you want to watch. It writes local hook config and never commits your key.

bash
curl -fsSL https://notifier.aicrew.in/install.sh | AGENT_NOTIFIER_SESSION_WATCHER=1 bash

Set watcher environment

Use per-project .env.local values so timelines group under the right project.

.env.local
AGENT_NOTIFIER_SESSION_WATCHER=1
AGENT_NOTIFIER_PROJECT=my-repo
AGENT_NOTIFIER_API_KEY=an_key_REPLACE_WITH_YOUR_KEY
# Optional: include safe prompt/tool summaries in timeline rows
AGENT_NOTIFIER_HOOK_INCLUDE_DETAILS=1

What you should see in the app

  • • Normal notifications keep appearing in the Notifications feed.
  • • Hooked sessions appear under Agentic Sessions or the project’s Sessions view.
  • • Waiting approvals may send an alert; routine tool events update the live session surface.
  • • If a session has zero linked events, it is diagnostics-only instead of cluttering the main app.

Two-way control

Steer your agents — one command

Post instructions to your agents from the app; a tiny worker on your machine picks them up. Install the dependency-free steer CLI with a single command — no 45-script setup.

bash
curl -fsSL https://notifier.aicrew.in/steer.sh | AGENT_NOTIFIER_API_KEY=an_key_REPLACE bash

Then run a worker that picks up tasks and kicks off an agent:

bash
steer run --scope user --exec 'claude'