Spinrun Docs
CLI

Options and exit codes

Every flag the CLI accepts and what its exit codes mean for scripts.

  • -d, --data <json> — arguments for execute; use "-" to read stdin
  • --data-file <p> — arguments from a file
  • --file <p> — a document for validate/put (default: stdin)
  • --prompt <text> — the prompt for agent test
  • --force — put/delete: allow webhook triggers to be removed
  • --json — print {"data": …} or {"error": …} instead of text
  • -n, --limit <n> — how many rows (logs, search)
  • -f, --follow — keep polling for new activity
  • --config-path <p> — override where install writes
  • --with-key <key> — install with an API key instead of browser auth
  • --build — install/gateway: the Build endpoint (OAuth only)
  • --refresh — ignore the cached tool list
  • -h, --help — this text
  • -v, --version — version

Exit codes

  • 0 — ok.
  • 1 — this program or the network: a bad flag, an unreadable file, a document over 64 KiB (checked before anything is sent), or agent test giving up after five minutes while the run continues on the server.
  • 2 — the server refused, including a 409; with --json the body is {"error", "current", "applied"}.

On this page