CLI Usage

Authentication

trigrun login -e [email protected] -p your-secure-password
trigrun token cron_pat_abc123def456...
trigrun whoami

Jobs

TrigRun evaluates cron expressions in UTC. Convert local wall-clock schedules to UTC before calling trigrun jobs create.

trigrun jobs list
trigrun jobs get JOB_ID
trigrun jobs create --name health-check --url https://httpbin.org/post --method POST --kind recurring --every 5
trigrun jobs pause JOB_ID
trigrun jobs resume JOB_ID
trigrun jobs run JOB_ID
trigrun jobs delete JOB_ID

Script jobs and executors

Use executor connections for scripts and long-running work. callback and poll modes let TrigRun park the execution while the executor does the work.

trigrun executors list
trigrun executors create --name production-runner --base-url https://runner.example.com --mode callback --auth-type bearer --auth-secret runner-token
trigrun executors test EXECUTOR_ID

trigrun jobs create-script \
  --name nightly-report \
  --cron "0 2 * * *" \
  --executor EXECUTOR_ID \
  --executor-mode callback \
  --command "node ./scripts/report.mjs" \
  --env REPORT_TOKEN=secret://report-token \
  --timeout-ms 7200000

Templates

trigrun templates list
trigrun templates list --category ai_agents
trigrun templates show health-check-ping

Executions

trigrun executions list
trigrun executions list --job JOB_ID
trigrun executions get EXECUTION_ID
trigrun executions replay EXECUTION_ID

Secrets

trigrun secrets list
trigrun secrets create --name api-key --value "sk_live_..."
trigrun secrets delete SECRET_ID

Notification channels and rules

trigrun channels list
trigrun channels create --name ops --type webhook --url https://example.com/hook
trigrun rules list JOB_ID
trigrun rules add JOB_ID --channel CHANNEL_ID --event on_failure
trigrun rules remove JOB_ID RULE_ID

Deliveries

trigrun deliveries list
trigrun deliveries list --status failed
trigrun deliveries retry DELIVERY_ID

Monitors

trigrun monitors list
trigrun monitors create --name nightly-backup --interval 3600 --grace 120
trigrun monitors get MONITOR_ID
trigrun monitors pause MONITOR_ID
trigrun monitors resume MONITOR_ID
trigrun monitors delete MONITOR_ID

Get command help

trigrun --help
trigrun jobs --help
trigrun executions --help

On this page