Skip to main content

CLI

Seiri has two CLI tools:

BinaryRole
seirictlManagement API client + ingest ping
seiriJob runner — wrap a command and ping on exit

seirictl​

Install​

# from source (013-seiri-ctl)
go build -o seirictl ./cmd/seirictl

Auth​

export SEIRI_API_URL="https://cloud.seiri.app"
export SEIRI_TOKEN="<access_token>"
export SEIRI_ORG_ID="<numeric_org_id>"

Or ~/.seiri/config.yaml:

api_url: https://cloud.seiri.app
token: eyJ...
org_id: "42"
ingest_url: https://ping.seiri.app

Useful commands​

seirictl me
seirictl webhooks list
seirictl webhooks create --name nightly-backup --type periodic --frequency 86400
seirictl webhooks test <id-or-ref>

# Public ingest (no JWT)
seirictl ping acme-demo:YOUR_REF
seirictl ping acme-demo:YOUR_REF --path /success
seirictl ping acme-demo:YOUR_REF --path /fail

# Raw OpenAPI paths
seirictl api GET /api/webhooks/analytics/performance

seiri (job runner)​

Wraps a shell command and reports success/fail to the ping URL:

go install github.com/seiri-cli/seiri@latest

seiri run --webhook=https://ping.seiri.app/webhook/acme-demo:YOUR_REF -- ./backup.sh

Always use ping.seiri.app for --webhook, never cloud.seiri.app.