TIDY CLI: Property Management from Your Terminal

If you live in the terminal, you shouldn't have to leave it to manage your properties. The TIDY CLI brings property management to the command line — schedule cleanings, report maintenance, check bookings, and manage your portfolio without opening a browser.

Install in Seconds

npm install -g @tidyapp/cli

Or run without installing:

npx @tidyapp/cli message "Schedule a cleaning next Tuesday"

What It Does

The TIDY CLI wraps our REST API into a developer-friendly interface. Everything you can do through the API, you can do from your terminal:

• Natural language requests — tidy message "Book a cleaning next week"
• Booking management — List, create, and cancel cleanings
• Maintenance tracking — Report issues, track resolution
• Property management — Manage addresses, access notes, parking info
• Guest reservations — Track check-ins and check-outs
• JSON output — Pipe results to jq, scripts, or other tools

Quick Tour

Authenticate

$ tidy login
Email: you@example.com
Password: ********
✓ Logged in successfully. Token saved.

Schedule a cleaning with natural language

$ tidy message "Schedule a 2-hour cleaning next Tuesday afternoon at my office"
✓ Booking created: #78901
  Date: Tuesday March 25, 1:00 PM - 5:00 PM
  Address: 456 Oak Ave

Check what's scheduled

$ tidy bookings list --upcoming
ID      Date         Address          Status
78901   Mar 25       456 Oak Ave      Confirmed
78902   Mar 27       123 Main St      Pending

Report a maintenance issue

$ tidy issues create --address 1001 --urgent "Kitchen faucet leaking"
✓ Issue created: #4567
  Priority: Urgent
  Status: Open

Get JSON output for scripting

$ tidy bookings list --upcoming --json | jq '.[].address'
"456 Oak Ave"
"123 Main St"

Why a CLI?

We built the TIDY CLI for developers who want to:

• Script property management — Cron jobs, CI/CD pipelines, or custom automation scripts
• Quick status checks — Faster than logging into a web app
• Combine with other tools — Pipe JSON output to jq, grep, or your own scripts
• Test API integrations — Verify requests before building them into your app

CLI vs MCP vs Skills

The CLI is for humans working in the terminal. If you want your AI agent to use TIDY:

• MCP Server — Direct tool access for Claude, Cursor, Codex, and other MCP agents
• Agent Skills — Pre-built workflow knowledge for the skills.sh ecosystem

All three use the same underlying REST API, so you can mix and match based on your workflow.

Get Started

npm install -g @tidyapp/cli && tidy login

Full command reference: CLI Reference Docs

See all developer tools: Developer Hub