Everything you need, nothing you don’t.
Short, practical guides. Every API call is also demoed live on your dashboard, so the fastest way to learn Chirp is to send a test activity and watch what happens.
Get started
2 min
Quick start
Install the iPhone app, grab an API key, and send your first Live Activity — three commands, under two minutes.
ReadOverview
Integrations
Every surface Chirp ships on today — SDKs, CLI, GitHub Actions, editor rules, webhooks.
ReadCopy & paste
Agent rule files
Drop .cursorrules / .windsurfrules / AGENTS.md into any repo so Cursor, Windsurf, or Claude Code auto-reach for Chirp.
ReadPrimitives
API
Live Activities
Start, update, and end a pinned lock-screen card backed by APNs. Idempotent per (user, schema_id).
ReadAPI
Push notifications
Fire-and-forget alerts via POST /v1/notify. Use these for one-shot events that don't need a persistent card.
ReadCatalog
Templates
Built-in schemas: @agent, @deploy, @training, @scrape, @monitor, @build, @test. Use these instead of designing your own.
ReadRecipes
Python
Python — @track decorator
Wrap any function in one line. Sync or async, auto-ends on exception.
ReadNode
Node — track() wrapper
Same ergonomics as Python. Ships Express error middleware too via chirp/express.
ReadLanguages
Go / Rust / Ruby SDKs
First-party clients for each — same Track() lifecycle, zero dependencies beyond stdlib (or a tiny HTTP crate for Rust).
ReadCLI
chirp run — wrap any command
Fire a Live Activity lifecycle around any shell command. Zero changes inside the script.
ReadShell
Bash helpers — cron, systemd, Docker
Source one file → chirp_notify / chirp_wrap / chirp_start available anywhere bash runs. No Python or Node required.
ReadCI/CD
CI/CD templates
GitHub Actions, GitLab CI, CircleCI, Bitbucket Pipelines — same schema, same shape across all of them.
ReadWebhooks
Webhook bridges
Vercel deploys, GitHub events, CircleCI, Stripe, Sentry, Grafana, Slack — paste a URL, done. Full list in Integrations.
ReadDon’t see your stack?
Every SDK in the world can speak HTTP. Chirp is four endpoints — /notify, /activity/start, /activity/update, /activity/end. Five minutes of curl gets you a working integration. If you want a first-party SDK for your language, open an issue.