Poke Co Ordering CLI

CLI for browsing menus and placing orders at The Poke Co (South Africa). All output is JSON. Requires Node.js.

Commands

Run via node scripts/poke-cli.js <command>.

Workflow

1. Find location: node scripts/poke-cli.js locations — pick one by name
2. Check hours: node scripts/poke-cli.js hours --location "Kloof" — confirm is_open: true
3. Search items: node scripts/poke-cli.js search --location "Kloof" --query "salmon" — find what to order
4. Place order: pipe JSON to node scripts/poke-cli.js order --from -

BYO Workflow

1. Find location: node scripts/poke-cli.js locations
2. Check hours: node scripts/poke-cli.js hours --location "Kloof"
3. Get options: node scripts/poke-cli.js byo-options --location "Kloof" — shows all available bases, proteins, toppings, sauces, crunches, extras with prices for both regular and maxi
4. Build bowl: node scripts/poke-cli.js byo --location Kloof --size regular --base ... --protein ... --topping ... --sauce ... --crunch ...

Always run byo-options first to see what ingredients are available before building a bowl.

Order JSON Format

{
  "location": "Kloof St",
  "mobile": "+27XXXXXXXXX",
  "order_type": "collection",
  "time": "asap",
  "items": [
    { "name": "Miso Soup", "quantity": 1 },
    {
      "name": "Build Your Own",
      "quantity": 1,
      "instructions": "Extra sauce",
      "choices": {
        "Choose Your Base": ["White Sushi Rice"],
        "Choose Your Protein": ["Salmon"]
      }
    }
  ]
}

Build Your Own (BYO) Command

The byo command provides a typed CLI for building custom bowls without needing to know the raw deal group structure.

Required flags:

• --location <name> — location (partial match)
• --size <regular|maxi> — bowl size (R83 regular, R99 maxi)
• --base <name> — 1-2 bases (repeat flag for split base, or "none")
• --protein <name> — 1 protein (or "none")
• --topping <name> — 1-4 toppings (repeat flag)
• --sauce <name> — 1-2 sauces (repeat flag), or "none" for no sauce
• --crunch <name> — 1 crunch (or "none")

Optional flags:

• --extra <name> — paid extras, up to 2 (repeat flag)
• --extra-protein <name> — extra protein
• --extra-sauce <name> — extra sauce (paid, repeat flag)
• --remove <name> — remove defaults
• --side <name> — add a side
• --drink <name> — add a drink
• --json — output order-ready JSON item (for piping into order)

Example:

node scripts/poke-cli.js byo --location Kloof --size regular \
  --base "sticky rice" --protein salmon \
  --topping mango --topping cucumber --topping edamame --topping radish \
  --sauce "house shoyu" --sauce "creamy togarashi" \
  --crunch "cashew nuts"

Discover options: Use byo-options --location <name> to see all available ingredients with prices.

Deal Items (generic)

When search returns an item with deal_groups, you must provide choices in the order:

• Each key is a partial match on the group's description
• Each value is an array of partial matches on option names
• Check required and min/max to know which groups need selections

Authentication

Ensure POKE_TOKEN=<token> is set

Errors

All errors return { "error": "..." } to stderr with exit code 1.

Tips

• Prefer search over menu — menu dumps 80+ items; search returns only matches
• Partial matching everywhere — "kloof" matches "Kloof St", "salmon" matches "Salmon Sashimi"
• Mobile format — use international format: +27XXXXXXXXX
• Filter by category — search --location Kloof --query rice --category sides