CLI Reference

Complete reference for all TIDY CLI commands. For a quick introduction, see the CLI Quickstart.

Global Options

Flag	Description
`--token <token>`	Override the stored API token for this command
`--json`	Output results as JSON instead of formatted text
`--help`	Show help for a command
`--version`	Show the CLI version

Authentication

`tidy login`

Authenticate with your TIDY account. Stores the token locally.

tidy login

`tidy logout`

Remove stored credentials.

tidy logout

Message

`tidy message <text>`

Send a natural language request to TIDY. This is the primary interface — describe what you need and TIDY handles the rest.

tidy message "Schedule a turnover clean after checkout on Saturday at 123 Main St"
tidy message "What cleanings are scheduled this week?"
tidy message "The bathroom faucet is leaking at my office, it's urgent"

Addresses

`tidy addresses list`

List all properties on your account.

tidy addresses list

`tidy addresses get <id>`

Get details for a specific address including access notes and parking info.

tidy addresses get 1001

Bookings

`tidy bookings list`

List bookings. Use flags to filter.

Flag	Description
`--upcoming`	Show only upcoming bookings
`--address <id>`	Filter by address ID
`--status <status>`	Filter by status (confirmed, pending, completed, cancelled)

`tidy bookings get <id>`

Get details for a specific booking.

`tidy bookings cancel <id>`

Cancel a booking.

Issues

`tidy issues list`

List maintenance issues and tasks.

Flag	Description
`--open`	Show only open issues
`--address <id>`	Filter by address ID

`tidy issues create`

Create a new maintenance issue.

Flag	Description
`--address <id>`	Address ID (required)
`--urgent`	Mark as urgent priority

tidy issues create --address 1001 --urgent "Kitchen faucet leaking"

Guest Reservations

`tidy reservations list`

List guest reservations with check-in/check-out dates.

Flag	Description
`--address <id>`	Filter by address ID
`--upcoming`	Show only upcoming reservations

Environment Variables

Variable	Description
`TIDY_API_TOKEN`	API token (overrides stored login)
`TIDY_API_URL`	API base URL (default: `https://api.tidy.com`)