CLI Commands

Authenticate the CLI with your Uptime Scheduler account.

uptime 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 uptime login to refresh.

uptime resources

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

uptime 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.

uptime report           # print summary to terminal
uptime 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.

uptime schedules

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

uptime start

Start resources immediately, bypassing the schedule.

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

# Start a specific resource by ID
uptime 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
uptime stop --env staging

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

Flags

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

Global flags

Flag	Description
`--version`	Print the CLI version and exit
`--help`	Show help for any command