# hooka

ntfy-style notification service. Topics fan out to Telegram chats or webhooks.

## Docs

- [/README.md](/README.md) — overview, env vars, local run, CLI examples
- [/docs/TUTORIALS.md](/docs/TUTORIALS.md) — video tutorials, sign-in to your own app
- [/docs/TELEGRAM_BOT_QUICKSTART.md](/docs/TELEGRAM_BOT_QUICKSTART.md) — build a Telegram bot on Hooka from scratch
- [/docs/CHAT_POLLING.md](/docs/CHAT_POLLING.md) — give another bot a read-only chat feed with cursor polling
- [/docs/INTEGRATION.md](/docs/INTEGRATION.md) — full integration guide (auth, routes, publish, SSE, reminders)
- [/docs/AGENT_BRIDGE.md](/docs/AGENT_BRIDGE.md) — run an external coding-agent bridge over Hooka topics
- [/docs/TELEPATHY_A2A.md](/docs/TELEPATHY_A2A.md) — Telepathy actor-to-actor messaging and A2A compatibility
- [/docs/API.md](/docs/API.md) — endpoint reference with request and response examples
- [/docs/SMS.md](/docs/SMS.md) — SMS routes over Twilio and Telnyx
- [/docs/openapi.yaml](/docs/openapi.yaml) — OpenAPI 3 spec
- [/web/src/lib/hooka-client.ts](/web/src/lib/hooka-client.ts) — canonical TypeScript client

## Operational endpoints

- `GET /health` — service + DB liveness
- `GET /ready` — DB readiness
- `GET /version` — deployed git SHA
- `GET /metrics` — Prometheus metrics

## Quick publish

```
curl -X POST "$HOOKA_URL/publish/your-topic" \
  -H "Authorization: Bearer $HOOKA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"text":"hello world","priority":3}'
```