# stdpush

> Private push notifications for developers: send from scripts, servers,
> CI pipelines and AI agents to your phone with one HTTP call, a CLI
> (`npm i -g stdpush`), and a Node SDK.

Full docs as one file: https://docs.stdpush.com/llms-full.txt

# Documentation

- [Getting started](https://docs.stdpush.com/docs): From zero to your first push in under a minute.
- [Authentication](https://docs.stdpush.com/docs/authentication): API keys, CLI tokens, and why there are no public topics.
- [Sending notifications](https://docs.stdpush.com/docs/sending): POST /v1/notify — fields, examples in four languages, idempotent retries.
- [Topics](https://docs.stdpush.com/docs/topics): Private routing between your projects and your devices.
- [CLI](https://docs.stdpush.com/docs/cli): stdpush login, run, listen — your terminal's missing output stream.
- [Node SDK](https://docs.stdpush.com/docs/sdk): The same npm package, imported instead of typed.
- [Claude Code & Codex](https://docs.stdpush.com/docs/agents): Know when your AI agent finishes, fails, or needs you.
- [CI & automation](https://docs.stdpush.com/docs/ci): GitHub Actions, cron, and anything that emits webhooks.
- [Limits & errors](https://docs.stdpush.com/docs/limits): Free-plan quotas, rate limits, and the error envelope.