status
Shows the current release, healthcheck result, runtime versions, revision metadata, and deployment lock state for the selected hosts.
Usage
bash
npx cata status [options]Options
| Option | Description |
|---|---|
--host <name>, -H <name> | Target a specific host |
--config <path>, -c <path> | Load a specific deploy config file |
--json | Output result as JSON |
With --json, all hosts are targeted by default (no interactive prompt) unless --host is provided, and results are aggregated into a single JSON document on stdout. Logs and errors are written to stderr.
Recipes can add entries to the report with onStatus — returned data appears both in the text output and in the host entries of the JSON document.
Examples
bash
npx cata status
npx cata status --host production
npx cata status -c deploy.staging.ts
npx cata status --json