@firfi/voila-cli

Command line interface for personal Voila grocery automation.

Defaults

• Session file: ~/.config/voila/session.json
• Browser profile: ~/.cache/voila/browser-profile
• Playwright browser cache: honors PLAYWRIGHT_BROWSERS_PATH; use ~/.cache/ms-playwright-voila for an isolated cache.

Commands

voila auth login --session ~/.config/voila/session.json
voila auth status --json
voila search "milk" --page-size 12
voila category products <category-id>
voila orders list --page-size 20
voila orders details <order-id>
voila orders items --from-date 2026-06-01 --to-date 2026-06-30
voila cart get
voila cart add <product-uuid> --quantity 1
voila cart remove <product-uuid> --quantity 1

auth login opens Chromium. Log in manually, then close the browser window to save. The CLI saves after Voila session material and cookies are captured, then validates the saved session.

orders list reads completed orders with cursor pagination; pass --page-token from the previous response to fetch the next page.

orders details reads item-level details for one completed order. orders items aggregates received items across completed orders, with optional date filters and --max-orders.

Cart commands use Voila product UUIDs. The CLI does not place orders.