SignalSitter CLI

Install npm install --global @signalsitter/cli, then run signalsitter --help. Supply your credential only through SIGNALSITTER_API_KEY in the environment. The public guide is https://docs.signalsitter.com/guides/cli.

Requires Node.js 22 or later. Use --json for data conforming to the REST response contract.

Licensed under MIT, matching the public FlowXO CLI package precedent. Bundled third-party notices are in THIRD_PARTY_LICENSES.

Repository-owned configuration (0.2.0 candidate)

CLI 0.2.0 adds versioned YAML/JSON config validate, config plan, and config apply. This version is a locally built candidate and has not been published to npm. Build/package this checkout for local use; after publication, pin exactly @signalsitter/[email protected] in CI.

signalsitter config validate signalsitter.yml --json
signalsitter config plan signalsitter.yml --environment staging --revision "$APPLICATION_REVISION" --json > plan.json
signalsitter config apply signalsitter.yml --environment staging --revision "$APPLICATION_REVISION" --plan plan.json --json

Validation is local. Planning uses existing project read authority; apply needs manage and runs only after the exact application revision deploys successfully. Named callback references select existing resources and accept no secret fields. Static monitor settings are supported; notification definitions, audience/consent and learned-detector settings are rejected.

See the configuration example for bootstrap, exact-identity adoption, drift resolution, emergency pause, safe removal, partial retries and the GitHub workflow. Partial apply prints its result and recovery instruction and exits 4; retain the exact saved plan to retry. Ordinary apply preserves pause/maintenance and never permanently deletes a monitor.