Book
Create checkout, render QR payment, and finalize booking.
Booking is a mutating local-terminal flow. Tranquilo rechecks the selected slot, sets the correct cart item, creates checkout, prints a QR/payment page handoff when available, polls payment, and finalizes the Pronto booking.
tranquilo househelp book --duration 60 --slot "tomorrow 6pm" --address-id 990330 --pay --open-qr --upi-app phonepeSlots are highly transient. A slot found earlier is not reliable later; Tranquilo revalidates before checkout and stops if the backend reports the slot is stale or overbooked.
Flags
| Flag | Required | Description |
|---|---|---|
--address-id <id> | No | Saved address id |
--lat <lat> | No | Latitude |
--lng <lng> | No | Longitude |
--duration <duration> | Yes | Duration to book such as 60, 90m, or 1.5h |
--duration-order <60,90,120,30> | No | Explicit duration fallback order, comma-separated |
--exact-duration | No | Only search the requested duration |
--date <YYYY-MM-DD> | No | Single target date |
--exact-date <YYYY-MM-DD> | No | Exact target date with no date fallback |
--around <YYYY-MM-DD> | No | Preferred date center for flexible date search |
--flex-days <n> | No | Days before/after --around |
--from-date <YYYY-MM-DD> | No | Target date range start |
--to-date <YYYY-MM-DD> | No | Target date range end |
--preset <preset> | No | Date preset Allowed values: today, tomorrow, next-4-days, weekend. |
--window <window> | No | Time window preset Allowed values: smart, before-work, after-work, weekend, any, custom. |
--time-window <HH:mm-HH:mm> | No | Preferred time window; repeatable |
--exact-time <HH:mm> | No | Exact start time |
--exact-slot <iso> | No | Exact slot start time |
--slot <time> | No | Selected slot start time, e.g. "today 6pm" or 2026-04-23T18:00 |
--rank <n> | No | Book the nth ranked live result for the same search filters |
--yes | No | Skip terminal confirmation |
--pay | No | Print QR and poll until payment finalizes; default for interactive terminal use |
--handoff | No | Prepare checkout only and print the local payment command instead of QR |
--copy-link | No | Copy the UPI URI to clipboard during payment |
--save-qr <path> | No | Save payment QR image to path |
--open-qr | No | Open the saved QR image with the OS image viewer |
--qr-size <size> | No | Terminal QR size for --pay Allowed values: compact, small, normal. Default: compact. |
--upi-app <app> | No | UPI app to route payment through; required for --pay until a local preference is saved Allowed values: phonepe, googlepay, paytm. |
--interval-ms <ms> | No | Payment poll interval for --pay |
--timeout-ms <ms> | No | Payment poll timeout for --pay |
--json | No | Print JSON |
--no-interactive | No | Never prompt; fail if more input is required |
Agent behavior
Local terminal agents may run this command after the user says to book and confirms any ambiguity. In Codex CLI, include --open-qr so the saved PNG opens in the local image viewer instead of depending on expanded terminal output. If no UPI preference exists, ask the user whether to use PhonePe, Google Pay, or Paytm and pass the answer as --upi-app. Hosted or web agents should use MCP to prepare a handoff and tell the user to complete payment locally.