Skip to content

Septiembre CLI

The septiembre CLI lets you manage Septiembre Cloud resources from your terminal or automation scripts. All commands output JSON by default, making it easy to pipe results into other tools.

  1. Install the CLI — download a binary from GitHub Releases or use go install.
  2. Create a personal access token: septiembre auth token create --name my-token --expires-at 2026-12-31T00:00:00Z
  3. Export the token: export SEPTIEMBRE_TOKEN=sapi_<your-token>
  4. Verify authentication: septiembre auth whoami
  5. List your organizations: septiembre orgs list

The CLI outputs JSON by default (--output json). Use --output table for human-readable terminal output. In scripts and agents, rely on the JSON output — its structure is stable and machine-parseable.

Terminal window
septiembre apps list --org my-org --output json
septiembre deploys list my-app-id --org my-org | jq '.[0].status'
PageWhat it covers
InstallationGitHub Releases binaries and go install
AuthenticationPersonal access tokens, environment variables, config file
ReferenceAll 17 commands, global flags, and exit codes
Agent usageJSON output patterns and scripting for AI agents