Templates

Built-in schemas you can send today.

Every template is rendered by the Chirp iPhone widget — no upload or native code required. Pass the id as schema_id and the fields below as data. If none of these fit your use case, register a custom layout at POST /v1/definitions.

Agents

@agent

Agent

Generic AI-agent or long-running task card. What Claude Code, Cursor agents, and autonomous loops should reach for by default.

agentNamestring Shown as the card title.
statusMessagestring Current step.
state"working" | "waiting" | "done" | "error" Drives the badge color.
themeColor#hex (optional) Override the default indigo tint.

copy & run

chirp activity start -s @agent -d '{
  "agentName": "Claude",
  "statusMessage": "Reviewing PR #204",
  "state": "working"
}'

CI/CD

@deploy

Deploy

Standard CI/CD pipeline card. Binds to the Vercel & GitHub Actions connectors automatically.

repostring Repository or service name.
stagestring building | testing | deploying | live | failed
progress0..1 Optional progress bar.

copy & run

chirp activity start -s @deploy -d '{
  "repo": "my-app",
  "stage": "building",
  "progress": 0.2
}'

@build

Build

Generic build card for xcodebuild, cargo, webpack, etc. Progress + step.

targetstring Build target name.
stagestring compile / link / archive / done.
progress0..1 Optional.

copy & run

chirp run -s @build -n "iOS archive" -- xcodebuild archive -scheme MyApp

@test

Test

Test-suite progress: passed/failed counters.

suitestring Suite label.
passedint Tests passing so far.
failedint Tests failing so far.
totalint (optional) Planned total.

copy & run

chirp run -s @test -n "full suite" -- npm test

ML/AI

@training

Training

Model training loop card. Epoch counter, loss, accuracy. The decorator pattern in the Python SDK targets this when `theme` and `name` suggest ML.

modelstring Model family / nickname.
epochint Current epoch (1-indexed).
totalEpochsint Planned total epochs.
lossfloat Most recent loss value.
valAccfloat (optional) Validation accuracy.

copy & run

chirp activity start -s @training -d '{
  "model": "llama-3-8b-ft",
  "epoch": 3,
  "totalEpochs": 10,
  "loss": 0.42
}'

Data

@scrape

Scrape

Web scraper or crawler. Pages + items counter; subtle enough to leave pinned on a long job.

pagesScrapedint Pages processed so far.
itemsFoundint Items extracted.
stagestring (optional) Human stage label.

copy & run

chirp activity start -s @scrape -d '{
  "pagesScraped": 412,
  "itemsFound": 1184
}'

Infra

@monitor

Monitor

Service health glance — green/amber/red badge with p50 latency. Good for uptime dashboards.

servicestring Service / endpoint name.
status"ok" | "degraded" | "down" Drives color.
latencyMsint (optional) Most recent p50.

copy & run

chirp activity start -s @monitor -d '{
  "service": "api.prod",
  "status": "ok",
  "latencyMs": 142
}'