Wolt CLI
Tool repository: https://github.com/mekedron/wolt-cli
Open the repository for setup/build details, then use the local wolt binary:
wolt <group> <command> [flags]
Session Startup
- Inspect command tree once per session:
wolt --help
- Prefer machine output for agent work:
... --format json
- Parse
.data from the envelope and surface .warnings/.error to the user.
Safety Rules
- Start read-only by default.
- Request explicit confirmation before mutating commands:
cart add, cart remove, cart clearprofile favorites add, profile favorites removeprofile addresses add, profile addresses update, profile addresses remove, profile addresses useconfigure (writes local profile credentials)
- Never describe
checkout preview as order placement. The CLI does not place final orders.
Auth Workflow
Use explicit profile names to avoid ambiguity:
wolt configure --profile-name default --wtoken "<token>" --wrtoken "<refresh-token>" --overwrite
wolt profile status --profile default --format json --verbose
Credential fallback for authenticated commands:
- Explicit flags (
--wtoken, --wrtoken, --cookie)
- Selected profile auth fields
- Default profile auth fields
When refresh credentials are available, expired/401 access tokens are refreshed automatically and persisted back to local config.
Location Rules
Apply exactly:
- Use either
--address "<text>" or both --lat + --lon.
- Do not combine
--address with --lat/--lon.
- If no override is passed, profile location is used.
search venues/items and venue show/hours use --address or profile location (no direct --lat/--lon flags).discover, cart, checkout preview, and profile favorites support --lat/--lon.
Command Selection
- Explore nearby options:
discover feed, discover categories, search venues, search items
- Inspect one venue deeply:
venue show, venue categories, venue search, venue menu, venue hours
- Resolve one item/options for basket actions:
item show, item options
- Basket and pricing:
cart count/show/add/remove/clear, then checkout preview
- Account and history:
profile show/status/orders/payments/addresses/favorites
For large marketplace venues, prefer:
venue search <slug> --query "<text>"venue menu <slug> --category <category-slug>
instead of unrestricted full-catalog menu crawl.
Output and Diagnostics
--format json|yaml returns envelope keys: meta, data, warnings, optional error.- On upstream failures, rerun with
--verbose to capture request trace and detailed diagnostics.
References
- Full command and flag matrix:
references/command-reference.md
- Reusable high-confidence workflows:
references/workflows.md
- Envelope/error parsing and automation notes:
references/output-and-errors.md
1---2name: wolt-cli3description: Use Nikita's local Wolt CLI to browse venues, inspect menus/items/options, and run profile, cart, and checkout-preview actions for wolt.com from terminal. Trigger when asked to find food on Wolt, inspect venue catalogs, resolve item/option IDs, automate basket or profile tasks, or debug Wolt auth/location/output behavior.4---5
6# Wolt CLI
7
8Tool repository: https://github.com/mekedron/wolt-cli
9
10Open the repository for setup/build details, then use the local `wolt` binary:
11
12```bash
13wolt <group> <command> [flags]
14```
15
16## Session Startup
17
181. Inspect command tree once per session:
19```bash
20wolt --help
21```
222. Prefer machine output for agent work:
23```bash
24... --format json
25```
263. Parse `.data` from the envelope and surface `.warnings`/`.error` to the user.
27
28## Safety Rules
29
30- Start read-only by default.
31- Request explicit confirmation before mutating commands:
32 - `cart add`, `cart remove`, `cart clear`
33 - `profile favorites add`, `profile favorites remove`
34 - `profile addresses add`, `profile addresses update`, `profile addresses remove`, `profile addresses use`
35 - `configure` (writes local profile credentials)
36- Never describe `checkout preview` as order placement. The CLI does not place final orders.
37
38## Auth Workflow
39
40Use explicit profile names to avoid ambiguity:
41
42```bash
43wolt configure --profile-name default --wtoken "<token>" --wrtoken "<refresh-token>" --overwrite
44wolt profile status --profile default --format json --verbose
45```
46
47Credential fallback for authenticated commands:
48
491. Explicit flags (`--wtoken`, `--wrtoken`, `--cookie`)
502. Selected profile auth fields
513. Default profile auth fields
52
53When refresh credentials are available, expired/401 access tokens are refreshed automatically and persisted back to local config.
54
55## Location Rules
56
57Apply exactly:
58
59- Use either `--address "<text>"` or both `--lat` + `--lon`.
60- Do not combine `--address` with `--lat/--lon`.
61- If no override is passed, profile location is used.
62- `search venues/items` and `venue show/hours` use `--address` or profile location (no direct `--lat/--lon` flags).
63- `discover`, `cart`, `checkout preview`, and `profile favorites` support `--lat/--lon`.
64
65## Command Selection
66
67- Explore nearby options: `discover feed`, `discover categories`, `search venues`, `search items`
68- Inspect one venue deeply: `venue show`, `venue categories`, `venue search`, `venue menu`, `venue hours`
69- Resolve one item/options for basket actions: `item show`, `item options`
70- Basket and pricing: `cart count/show/add/remove/clear`, then `checkout preview`
71- Account and history: `profile show/status/orders/payments/addresses/favorites`
72
73For large marketplace venues, prefer:
74
75- `venue search <slug> --query "<text>"`
76- `venue menu <slug> --category <category-slug>`
77
78instead of unrestricted full-catalog menu crawl.
79
80## Output and Diagnostics
81
82- `--format json|yaml` returns envelope keys: `meta`, `data`, `warnings`, optional `error`.
83- On upstream failures, rerun with `--verbose` to capture request trace and detailed diagnostics.
84
85## References
86
87- Full command and flag matrix: `references/command-reference.md`
88- Reusable high-confidence workflows: `references/workflows.md`
89- Envelope/error parsing and automation notes: `references/output-and-errors.md`
modbender