# Notify

> Send Telegram notifications to a topic-routed group chat. Supports multiple sources (alerts, nightshift, email, jobs) each routing to a dedicated Telegram topic. Use when: a task completes, hitting a blocker, waiting for user input, reporting errors, or sending urgent alerts. Available via shell function and HTTP API. NOT for: asking the user questions (use AskUserQuestion), routine progress updates, or sending messages to external contacts.

- Skill: `etanhey/notify` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add etanhey/notify`
- Raw SKILL.md: https://api.skillmd.com/api/skills/etanhey/notify/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: EtanHey (https://skillmd.com/u/etanhey)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/etanhey/notify

---


# Telegram Notifications

Notifications are sent to a **group with Topics**. Each source routes to a different topic.

## Quick Usage (CLI)

```bash
# Goes to 🔔 Alerts (default for CLI sessions)
notify "Task Done" "Finished implementing the feature"

# Specify source to route elsewhere
notify "Title" "Body" "jobs"     # → 🎯 Jobs
notify "Title" "Body" "email"    # → 📧 Email
```

## Topic Routing

| Source | Routes To | Used By |
|--------|-----------|---------|
| `alerts` | 🔔 Alerts | CLI sessions (default), Golems |
| `claude` | 💬 General | ClaudeGolem only (DO NOT use from CLI) |
| `nightshift` | 🌙 Night Shift | Night Shift golem |
| `email` | 📧 Email | EmailGolem |
| `jobs` | 🎯 Jobs | JobGolem |
| `healthcheck` | 🔔 Alerts | Daily healthcheck |

_Note: ClaudeGolem chat goes to General (Telegram's default topic)_

## HTTP API (for TypeScript)

```typescript
await fetch("http://localhost:3847/notify", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    title: "Title",
    body: "Message body",
    source: "alerts",  // or email, jobs, nightshift
    priority: "default",  // or "high" for urgent
  }),
});
```

## When to Notify

**DO notify:**
- Task complete (commit, PR, feature done)
- Waiting for input (blocked, need decision)
- CLAUDE_COUNTER hits 0 (still working)
- Errors or failures

**DON'T notify:**
- Routine progress (reading files)
- Every small step
- Questions (use AskUserQuestion instead)

## Tips

- **Title:** 2-4 words max
- **Body:** 1 sentence max
- **Escaping:** The `notify` CLI handles special chars automatically
- **High priority:** Only use for urgent issues needing immediate attention