Peckish 🍜

Feeling peckish? Just ask. An AI ordering agent for DoorDash — it searches, compares real totals (fees included), builds the cart, and you approve every order. Built on Claude and DoorDash's official dd-cli.

One tool layer, three surfaces:

Which one is for me?

• Comfortable with a terminal? → Terminal chat. Fastest, most informative.
• Want something that feels like an app? → Local web app. Cards, live quote, a proper Place-order button.
• Already use Claude Desktop or Claude Code? → MCP server. No API key, no separate chat window — Claude itself becomes your ordering agent, and order confirmation appears as a native dialog.

_{Scripted demo of the web app — store, prices and card are fictional; the interface and the approval gate are the real ones.}

peckish on the web →

Updates: every release ships with full notes, all artifacts, and a SHA256SUMS.txt on Releases — see CHANGELOG.md for the history. Watch the repo (Releases only) to get notified.

Install in one line — no git clone:

npm install -g peckish

Prefer an app? Download the Mac app (.dmg) — guided setup, no terminal at any step. See Mac app below. Everything runs on your own machine either way, because dd-cli holds your DoorDash session there — a Mac (Apple Silicon) or Linux x86_64, including containers and cloud sandboxes: see Linux, containers and headless hosts.

you › Find me a high-protein dinner under $25 that can arrive within 45
      minutes. Avoid mushrooms and excessive fees.

⚙ search_restaurants {"query":"grilled chicken bowls","limit":8}  ✓ 2.1s
⚙ get_menu {"store_id":"35406455","filter":"chicken"}             ✓ 1.8s
⚙ list_carts {"store_id":"35406455"}                              ✓ 1.2s
⚙ add_items_to_cart {…}                                           ✓ 2.4s
⚙ preview_order {"cart_uuid":"…"}                                 ✓ 3.9s

Best fit: Sharon Korean Kitchen (4.8★, ~24 min) — Grilled Chicken Bulgogi
Bowl, $16.95. No mushrooms listed. Total with fees: $21.40 on your Visa
ending 1234. Suggested Dasher tip is $3.50 — that, another amount, or none?
~$0.04 turn · $0.04 session

Get started (user guide)

1. Prerequisites

• A Mac with Apple Silicon (M1–M4) or Linux x86_64 — the two platforms dd-cli publishes builds for. Peckish is local-first: whichever machine you run it on is the backend on every surface, because that's where dd-cli holds your DoorDash session.
• Node.js 20+ — node --version to check; install from nodejs.org or brew.
• DoorDash CLI access (currently waitlist-gated by DoorDash). Peckish requires dd-cli ≥ 0.2.1 — on Linux, ≥ 0.2.2, the first release with Linux builds — and targets ≥ 0.2.5, the current release. Older binaries still order fine; Peckish reads dd-cli --version at startup and turns off only what that build can't do (see dd-cli versions). Download the release from doordash-oss/doordash-cli, verify the SHA256 checksum against the published value, then:
  sh

  Copy

  # macOS (Apple Silicon)
  tar -xzf dd-cli-v*-darwin-arm64.tar.gz && cd dd-cli-v*-darwin-arm64
  # Linux (x86_64)
  tar -xzf dd-cli-v*-linux-amd64.tar.gz && cd dd-cli-v*-linux-amd64
  
  bash install.sh          # both platforms — installs to ~/.local/bin/dd-cli
  dd-cli login             # sign in to DoorDash in your browser
  

  No browser on that machine (container, VM, cloud sandbox)? See Linux, containers and headless hosts.
• An Anthropic API key for the terminal/web surfaces (console.anthropic.com) — or skip the key entirely and use the MCP surface with your Claude subscription (step 4).

2. Install Peckish

npm install -g peckish

That's it — you now have three commands: peckish (terminal chat), peckish-web (web app), and peckish-mcp (MCP server).

git clone https://github.com/CydVilla/peckish.git
cd peckish
npm install
npm test          # optional: 25 unit tests, no network needed
npm run dev       # terminal chat (or: npm run web / npm run mcp)

3. Run it — terminal or web

export ANTHROPIC_API_KEY=sk-ant-…   # from console.anthropic.com

peckish         # terminal chat
peckish-web     # web app → open http://localhost:4747

On boot Peckish verifies your DoorDash sign-in, shows your default delivery address, and flags any open carts you forgot about. If sign-in is missing or expired, Peckish offers to fix it for you: the terminal asks before launching dd-cli login (which opens your browser), the web app shows a sign-in card, and mid-conversation the agent can offer the same assist on any surface — you approve, sign in in the browser, and it picks up where it left off. On a machine with no browser, Peckish skips that offer and tells you how to inject a token instead — see below.

4. Or run it inside Claude — no API key

Claude itself becomes the ordering agent, and your Claude subscription pays for the model. Pick whichever fits your client:

Claude Code — one line:

claude mcp add peckish -- npx -y peckish-mcp

Claude Desktop — download peckish-0.2.2.mcpb from Releases and double-click it. Claude Desktop installs it like a browser extension: no terminal, no Node install, no JSON editing.

{
  "mcpServers": {
    "peckish": {
      "command": "npx",
      "args": ["-y", "peckish-mcp"]
    }
  }
}

Peckish is also listed in the MCP Registry as io.github.CydVilla/peckish, so clients that browse the registry can find it directly.

Restart Claude Desktop and ask it to find you dinner. Order confirmation appears as a native dialog; clients that can't render dialogs can browse and build carts but cannot place orders (fail closed).

5. Everyday use

Things to say:

• "Find me a high-protein dinner under $25 that can arrive within 45 minutes. Avoid mushrooms and excessive fees."
• "Compare the real totals at the top two — fees included."
• "Reorder my usual from Sharon Korean."
• "What did I spend on delivery last month?"
• "Is this place actually good?" (checks web reviews)
• "Never mushrooms, ever." → saved permanently; applied automatically next time
• "Get me milk, eggs, and a pound of ground beef from Whole Foods."

Placing an order always ends with an explicit confirmation you perform — typing yes in the terminal, clicking Place order in the web modal, or approving the dialog in Claude Desktop. Before that, Peckish must show you the itemized quote, confirm the tip, and name the card being charged. Decline anything and it backs off.

Controls & housekeeping

Cost: defaults are tuned for low spend at decent quality — claude-sonnet-5 at medium effort, prompt caching on the system prefix and conversation tail, and server-side context editing that prunes stale menu payloads in long sessions. The cost meter shows the approximate spend per turn and per session. Max quality: DD_AGENT_MODEL=claude-opus-4-8 DD_AGENT_EFFORT=high. (On MCP, the client chooses and pays for the model.)

Troubleshooting