CLI Commands

Authenticate the CLI with your Uptime Scheduler account.

uptimectl login

Opens a browser-based approval flow. Once approved, credentials are stored in ~/.uptime/credentials.json and reused automatically. Sessions expire after 90 days — re-run uptimectl login to refresh.

uptime resources

Open an interactive table of all discovered resources across your connected AWS accounts.

uptimectl resources

Columns

Column	Description
Resource ID	AWS resource ID or ARN
Type	EC2, RDS, ECS, NAT, etc.
Env	Value of the `uptime:env` tag, or `—` if unset
Region	AWS region
Full Cost	Always-on monthly cost (rate × 730 hrs)
Sched. Cost	Monthly cost when following the assigned schedule
Status	`Active` or `Idle`
Last Seen Active	Timestamp of the last recorded state change

Keys

Key	Action
`↑` / `↓` or `j` / `k`	Navigate rows
`Enter`	Open resource detail panel
`q` / `Esc`	Quit

uptime report

Print a cost savings summary grouped by resource type, then open a browser-based report.

uptimectl report           # print summary to terminal
uptimectl report --open    # print summary and open web report

Output includes

Total resources scanned
Number of idle resources
Potential monthly savings if schedules are followed
Breakdown table by resource type

uptime schedules

List all schedules and the resources assigned to them.

uptimectl schedules

Displays each unique schedule (e.g. 9-17 mon-fri) alongside the resources it controls, their current state, region, and timezone.

uptimectl start

Start resources immediately, bypassing the schedule.

# Start all resources in one or more environments
uptimectl start --env production
uptimectl start --env staging --env dev

# Start a specific resource by ID
uptimectl start --resource i-0c9e318a81b68f747

Flags

Flag	Description
`--env <name>`	Environment name (matches the `uptime:env` tag). Repeatable.
`--resource <id>`	AWS resource ID or ARN

uptime stop

Stop resources immediately, bypassing the schedule.

# Stop all resources in an environment
uptimectl stop --env staging

# Stop a specific resource
uptimectl stop --resource i-0c9e318a81b68f747