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-request login`

Authenticate with your TIDY account. Stores the token locally.

tidy-request login

`tidy-request logout`

Remove stored credentials.

tidy-request logout

Message

`tidy-request message <text>`

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

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

Addresses

`tidy-request addresses list`

List all properties on your account.

tidy-request addresses list

`tidy-request addresses get <id>`

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

tidy-request addresses get 1001

Bookings

`tidy-request 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-request bookings get <id>`

Get details for a specific booking.

`tidy-request bookings cancel <id>`

Cancel a booking.

Issues

`tidy-request issues list`

List maintenance issues and tasks.

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

`tidy-request issues create`

Create a new maintenance issue.

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

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

Guest Reservations

`tidy-request 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`)