pp-dominos

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Domino's — Printing Press CLI

Domino's — Printing Press CLI

Prerequisites: Install the CLI

前提条件:安装CLI

This skill drives the
dominos-pp-cli
binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:
  1. Install via the Printing Press installer:
    bash
    npx -y @mvanhorn/printing-press install dominos --cli-only
  2. Verify:
    dominos-pp-cli --version
  3. Ensure
    $GOPATH/bin
    (or
    $HOME/go/bin
    ) is on
    $PATH
    .
If the
npx
install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.23+):
bash
go install github.com/mvanhorn/printing-press-library/library/food-and-dining/dominos/cmd/dominos-pp-cli@latest
If
--version
reports "command not found" after install, the install step did not put the binary on
$PATH
. Do not proceed with skill commands until verification succeeds.
本技能基于
dominos-pp-cli
二进制文件运行。在调用本技能的任何命令之前,您必须确认CLI已安装。 如果未安装,请先执行以下步骤:
  1. 通过Printing Press安装程序安装:
    bash
    npx -y @mvanhorn/printing-press install dominos --cli-only
  2. 验证安装:
    dominos-pp-cli --version
  3. 确保
    $GOPATH/bin
    (或
    $HOME/go/bin
    )已添加到
    $PATH
    环境变量中。
如果
npx
安装失败(无Node环境、离线等情况),可改用Go直接安装(要求Go 1.23及以上版本):
bash
go install github.com/mvanhorn/printing-press-library/library/food-and-dining/dominos/cmd/dominos-pp-cli@latest
如果安装后执行
--version
提示“command not found”,说明安装程序未将二进制文件添加到
$PATH
中。请在验证成功前不要执行技能命令。

When to Use This CLI

何时使用该CLI

Use this CLI when an agent or power user needs to interact with Domino's outside a browser — building, pricing, and placing orders, tracking deliveries, comparing prices across stores, optimizing deal selection, or replaying saved order templates. Excellent for automation: every command supports --json, --dry-run, --agent, --select, and structured exit codes. Local SQLite store enables features the public API cannot serve directly (deal optimization, multi-store wait-time comparison, named order templates). DO NOT use this CLI for: other pizza chains (Pizza Hut, Papa John's, etc.), generic food delivery (DoorDash, Uber Eats), restaurant search/aggregation, or non-US Domino's storefronts (only US endpoints are supported).
当Agent或高级用户需要在浏览器外与Domino's交互时使用该CLI——包括创建、定价、下单、跟踪配送、跨门店对比价格、优化优惠选择或复用已保存的订单模板。该CLI非常适合自动化场景:每个命令都支持
--json
--dry-run
--agent
--select
参数以及结构化退出码。本地SQLite存储支持公开API无法直接提供的功能(优惠优化、多门店等待时间对比、命名订单模板)。请勿将该CLI用于以下场景:其他披萨连锁店(必胜客、棒约翰等)、通用外卖平台(DoorDash、Uber Eats)、餐厅搜索/聚合服务,或美国以外的Domino's门店(仅支持美国地区端点)。

Unique Capabilities

独特功能

These capabilities aren't available in any other tool for this API.
这些功能是其他同类型API工具所不具备的。

Local state that compounds

可累积的本地状态

  • template save
    — Save your usual order — store, address, items, toppings, payment ref — and replay it with one command.
    Reach for this when an agent or user wants a one-command repeat of a known-good order without rebuilding the cart from scratch.
    bash
    dominos-pp-cli template save friday-night --from-cart && dominos-pp-cli template order friday-night --eta-watch --json
  • reorder
    — Replay your last order against today's menu; FTS-substitute items the menu rotated out so the order still goes through.
    Reach for this when a saved-order-style replay must survive Domino's menu rotation; substitution avoids the 'this item is no longer available' failure.
    bash
    dominos-pp-cli reorder --last --substitute-unavailable --dry-run --json
  • deals best
    — Cross-reference your cart against every available deal (incl. loyalty-exclusive) and report the lowest-priced combination.
    Reach for this before placing an order whenever the user cares about price; the flag enumerates 2-3-deal combinations the website never surfaces.
    bash
    dominos-pp-cli deals best --agent
  • analytics
    — Aggregate your synced order history into spending totals, item frequency, favorite stores, and average order value.
    Reach for this when 'how much have I spent on pizza this quarter' or 'what are my top 3 items' is the question. Powered entirely by the local SQLite order history.
    bash
    dominos-pp-cli analytics --period 90d --group-by item --agent
  • template save
    — 保存您常用的订单信息——门店、地址、商品、配料、支付参考——并通过一条命令复用订单。
    当Agent或用户希望通过一条命令重复已知的有效订单,而无需从头重建购物车时,可使用该命令。
    bash
    dominos-pp-cli template save friday-night --from-cart && dominos-pp-cli template order friday-night --eta-watch --json
  • reorder
    — 基于今日菜单复用您的上一次订单;对于菜单中已下架的商品,会通过FTS自动替换,确保订单可正常提交。
    当需要复用已保存的订单,但Domino's菜单已更新时,可使用该命令;自动替换功能可避免“该商品已下架”的错误。
    bash
    dominos-pp-cli reorder --last --substitute-unavailable --dry-run --json
  • deals best
    — 将您的购物车与所有可用优惠(包括会员专属优惠)进行交叉比对,报告最低价格组合。
    当用户在意订单价格时,下单前可使用该命令;该命令会列举出官网从未展示的2-3种优惠组合。
    bash
    dominos-pp-cli deals best --agent
  • analytics
    — 将您的同步订单历史汇总为消费总额、商品购买频率、偏好门店和平均订单金额。
    当用户提出“本季度我在披萨上花了多少钱”或“我最常买的3种商品是什么”这类问题时,可使用该命令。完全基于本地SQLite订单历史提供数据。
    bash
    dominos-pp-cli analytics --period 90d --group-by item --agent

Cross-source insights

跨源洞察

  • compare-prices
    — Same cart priced at every nearby store; rank by total including delivery fee.
    Reach for this when latency-or-price tradeoffs across nearby stores matter (delivery fee + wait time can offset a cheaper menu).
    bash
    dominos-pp-cli compare-prices --address "421 N 63rd St" --city "Seattle WA" --items S_PIZPH,S_LAVA --agent
  • stores wait
    — Pull CartEtaMinutes for every store in radius and rank by ETA — the unique GraphQL BFF op every other wrapper ignores.
    Reach for this when busy-hour delivery decisions need accurate wait estimates rather than a phone call to the store.
    bash
    dominos-pp-cli stores wait --address "421 N 63rd St" --city "Seattle WA" --agent
  • deals eligible
    — List which advertised deals actually apply to your current cart and explain why each non-matching one fails.
    Reach for this when the user is hunting for a coupon and needs to understand the predicate gap, not just whether 'a deal' applies.
    bash
    dominos-pp-cli deals eligible --agent
  • compare-prices
    — 在所有附近门店计算同一购物车的价格;包含配送费的总价进行排序。
    当需要在附近门店之间权衡配送延迟与价格时(配送费+等待时间可能抵消菜单价格优势),可使用该命令。
    bash
    dominos-pp-cli compare-prices --address "421 N 63rd St" --city "Seattle WA" --items S_PIZPH,S_LAVA --agent
  • stores wait
    — 获取指定范围内所有门店的CartEtaMinutes数据,并按等待时间排序——这是其他包装工具都忽略的独特GraphQL BFF操作。
    当高峰时段需要准确的配送等待时间估算,而非致电门店询问时,可使用该命令。
    bash
    dominos-pp-cli stores wait --address "421 N 63rd St" --city "Seattle WA" --agent
  • deals eligible
    — 列出哪些公开优惠适用于当前购物车,并解释不符合的优惠未生效的原因。
    当用户寻找优惠券,且需要了解优惠不适用的具体原因,而非仅知道“是否有优惠适用”时,可使用该命令。
    bash
    dominos-pp-cli deals eligible --agent

Agent-native plumbing

Agent原生管道

  • track
    — Stream Domino's tracker stages — placed → prep → bake → quality check → out → delivered — until the order arrives.
    Reach for this when an agent or user wants to know precisely when a placed order changes stage without holding open a browser tab.
    bash
    dominos-pp-cli track --phone 2065551234 --watch --interval 30s --agent
  • order-quick
    — Replay a template, validate, price, place (with --confirm), and tail the tracker — all in one command emitting a final JSON envelope.
    Reach for this when an agent or automation wants to trigger an order and exit cleanly with structured
    {order_id, eta_min, total, tracker_phone}
    output.
    bash
    dominos-pp-cli order-quick --template friday-night --confirm --eta-watch --json
  • track
    — 流式输出Domino's订单跟踪状态——已下单 → 准备中 → 烘焙中 → 质量检查 → 配送中 → 已送达——直到订单完成配送。
    当Agent或用户希望精准了解已下单订单的状态变化,而无需保持浏览器标签页打开时,可使用该命令。
    bash
    dominos-pp-cli track --phone 2065551234 --watch --interval 30s --agent
  • order-quick
    — 复用模板、验证订单、计算价格、提交订单(需添加
    --confirm
    参数)并跟踪订单状态——所有操作通过一条命令完成,最终输出JSON格式结果。
    当Agent或自动化流程需要触发订单并以结构化的
    {order_id, eta_min, total, tracker_phone}
    输出干净退出时,可使用该命令。
    bash
    dominos-pp-cli order-quick --template friday-night --confirm --eta-watch --json

HTTP Transport

HTTP传输

This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints. It does not require a resident browser process for normal API calls.
该CLI使用兼容Chrome的HTTP传输方式访问面向浏览器的端点。正常API调用无需常驻浏览器进程。

Discovery Signals

发现信号

This CLI was generated with browser-observed traffic context.
  • Capture coverage: 0 API entries from 0 total network entries
  • Auth signals: bearer_token
该CLI是基于浏览器捕获的流量上下文生成的。
  • 捕获覆盖率:0个API条目(共0个网络条目)
  • 认证信号:bearer_token

Command Reference

命令参考

customer — Customer profile, order history, and loyalty (requires
auth login
)
  • dominos-pp-cli customer loyalty
    — Loyalty points balance, tier status, and pending points for the customer.
  • dominos-pp-cli customer orders
    — List the customer's recent orders. Returns full Order objects (Address, Products, Amounts, Coupons, Status, etc.)...
graphql — GraphQL BFF operations (discovered via sniff)
  • dominos-pp-cli graphql categories
    — Get menu categories for a store
  • dominos-pp-cli graphql create_cart
    — Create a new shopping cart
  • dominos-pp-cli graphql customer
    — Get authenticated customer profile with saved addresses and preferences
  • dominos-pp-cli graphql deals_list
    — Get available deals and coupons for a store
  • dominos-pp-cli graphql get_cart
    — Get cart by ID with items and pricing
  • dominos-pp-cli graphql loyalty_deals
    — Get member-exclusive deals
  • dominos-pp-cli graphql loyalty_points
    — Get loyalty points balance and status
  • dominos-pp-cli graphql loyalty_rewards
    — Get available loyalty rewards by tier
  • dominos-pp-cli graphql products
    — Get products in a category with customization options
  • dominos-pp-cli graphql quick_add_product
    — Quick-add a product to cart by code
  • dominos-pp-cli graphql summary_charges
    — Get cart totals including tax and delivery fee
menu — Browse store menus and search for items
  • dominos-pp-cli menu <storeID>
    — Get the full menu for a store with categories, products, variants, and toppings
orders — Create, validate, price, and place orders
  • dominos-pp-cli orders place
    — Place an order for delivery or carryout
  • dominos-pp-cli orders price
    — Get the price for an order including taxes and fees
  • dominos-pp-cli orders validate
    — Validate an order before placing it
stores — Find and get information about Domino's stores
  • dominos-pp-cli stores find
    — Find nearby Domino's stores by address
  • dominos-pp-cli stores get
    — Get detailed store information including hours, capabilities, and wait times
tracking — Track active orders
  • dominos-pp-cli tracking
    — Track an order by phone number
customer — 客户档案、订单历史和会员服务(需先执行
auth login
  • dominos-pp-cli customer loyalty
    — 查询客户的会员积分余额、等级状态和待入账积分。
  • dominos-pp-cli customer orders
    — 列出客户的近期订单。返回完整的Order对象(地址、商品、金额、优惠券、状态等)...
graphql — GraphQL BFF操作(通过流量嗅探发现)
  • dominos-pp-cli graphql categories
    — 获取门店的菜单分类
  • dominos-pp-cli graphql create_cart
    — 创建新购物车
  • dominos-pp-cli graphql customer
    — 获取已认证客户档案,包含已保存的地址和偏好设置
  • dominos-pp-cli graphql deals_list
    — 获取门店的可用优惠和优惠券
  • dominos-pp-cli graphql get_cart
    — 通过ID获取购物车信息,包含商品和定价
  • dominos-pp-cli graphql loyalty_deals
    — 获取会员专属优惠
  • dominos-pp-cli graphql loyalty_points
    — 获取会员积分余额和状态
  • dominos-pp-cli graphql loyalty_rewards
    — 获取对应等级的可用会员奖励
  • dominos-pp-cli graphql products
    — 获取分类下的商品及自定义选项
  • dominos-pp-cli graphql quick_add_product
    — 通过编码快速将商品添加到购物车
  • dominos-pp-cli graphql summary_charges
    — 获取购物车总金额,包含税费和配送费
menu — 浏览门店菜单并搜索商品
  • dominos-pp-cli menu <storeID>
    — 获取门店的完整菜单,包含分类、商品、变体和配料
orders — 创建、验证、定价和提交订单
  • dominos-pp-cli orders place
    — 提交配送或到店取餐订单
  • dominos-pp-cli orders price
    — 获取订单价格,包含税费和服务费
  • dominos-pp-cli orders validate
    — 提交订单前验证订单信息
stores — 查找Domino's门店并获取相关信息
  • dominos-pp-cli stores find
    — 通过地址查找附近的Domino's门店
  • dominos-pp-cli stores get
    — 获取门店详细信息,包含营业时间、服务能力和等待时间
tracking — 跟踪活跃订单
  • dominos-pp-cli tracking
    — 通过电话号码跟踪订单

Finding the right command

查找合适的命令

When you know what you want to do but not which command does it, ask the CLI directly:
bash
dominos-pp-cli which "<capability in your own words>"
which
resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code
0
means at least one match; exit code
2
means no confident match — fall back to
--help
or use a narrower query.
当您知道要执行的操作,但不知道对应命令时,可直接询问CLI:
bash
dominos-pp-cli which "<用您自己的语言描述功能>"
which
命令会将自然语言的功能查询解析为CLI精选功能索引中最匹配的命令。退出码
0
表示至少有一个匹配项;退出码
2
表示无匹配项——此时可使用
--help
参数或缩小查询范围。

Recipes

使用示例

Full real-world flow: closest store → menu → cart → deals

完整真实流程:最近门店 → 菜单 → 购物车 → 优惠

bash
undefined
bash
undefined

1. Find closest store (no auth needed)

1. 查找最近的门店(无需认证)

dominos-pp-cli stores find --address "709 19th Ave" --city "Seattle WA 98122" --json
dominos-pp-cli stores find --address "709 19th Ave" --city "Seattle WA 98122" --json

2. List all coupons available at that store (no auth needed; 58 coupons)

2. 列出该门店的所有优惠券(无需认证;共58张优惠券)

dominos-pp-cli deals list --store-id 7144 --json
dominos-pp-cli deals list --store-id 7144 --json

3. Build a cart (local, no API call)

3. 创建购物车(本地操作,无需API调用)

dominos-pp-cli cart new --store 7144 --service Delivery --address "709 19th Ave, Seattle WA 98122" dominos-pp-cli cart add 12THIN --qty 1 # Medium 12" Thin Pizza dominos-pp-cli cart add F_PBITES --qty 1 # Parmesan Bread Bites
dominos-pp-cli cart new --store 7144 --service Delivery --address "709 19th Ave, Seattle WA 98122" dominos-pp-cli cart add 12THIN --qty 1 # 12英寸薄底中号披萨 dominos-pp-cli cart add F_PBITES --qty 1 # 帕玛森面包丁

4. See which coupons auto-apply (real auto-couponing-service call)

4. 查看哪些优惠券可自动应用(调用真实的自动优惠券服务)

dominos-pp-cli deals best --json dominos-pp-cli deals eligible --json

Every step talks to a real Domino's endpoint and returns real data. The deals call correctly identifies which store coupons fulfill your specific cart.
dominos-pp-cli deals best --json dominos-pp-cli deals eligible --json

每个步骤都会调用真实的Domino's端点并返回真实数据。优惠查询会正确识别哪些门店优惠券适用于您的特定购物车。

Friday night reorder, hands-off

周五晚一键复购,无需手动操作

bash
dominos-pp-cli order-quick --template friday-night --confirm --eta-watch --json
Replay a saved template, validate, price, place (with --confirm), and tail the tracker. Emits a final JSON envelope with order_id, eta_min, and total. Requires a template named friday-night — see
template save
. Without
--confirm
, returns a dry-run preview (no order placed).
bash
dominos-pp-cli order-quick --template friday-night --confirm --eta-watch --json
复用已保存的模板、验证订单、计算价格、提交订单(需
--confirm
参数)并跟踪订单状态。最终输出包含order_id、eta_min和total的JSON结果。需要提前保存名为friday-night的模板——详见
template save
命令。如果未添加
--confirm
参数,仅返回预演结果(不会提交订单)。

Authenticated commands (after
auth login
)

已认证命令(执行
auth login
后)

bash
undefined
bash
undefined

Order history

订单历史

dominos-pp-cli customer orders --limit 5 --json
dominos-pp-cli customer orders --limit 5 --json

Loyalty points balance

会员积分余额

dominos-pp-cli customer loyalty --json

Customer ID is the long base64-style identifier from your sign-in. Once `auth login` completes, the bearer token persists in `~/.config/dominos-pp-cli/config.toml` until Dominos expires it (~1 hour).
dominos-pp-cli customer loyalty --json

客户ID是登录后获取的长base64格式标识符。`auth login`完成后,Bearer令牌会保存在`~/.config/dominos-pp-cli/config.toml`中,直到Domino's将其过期(约1小时)。执行`auth status`可确认认证状态;执行`auth logout`可清除令牌。

Find the cheapest store for tonight's order (agent + select for narrow output)

查找今晚订单最便宜的门店(Agent模式+筛选输出字段)

bash
dominos-pp-cli compare-prices --address "421 N 63rd St" --city "Seattle WA" --items S_PIZPH,S_LAVA --agent --select results[].store_id,results[].total_cents
Surveys nearby stores and returns only the comparison fields the agent needs.
bash
dominos-pp-cli compare-prices --address "421 N 63rd St" --city "Seattle WA" --items S_PIZPH,S_LAVA --agent --select results[].store_id,results[].total_cents
调查附近门店并仅返回Agent所需的对比字段。

Hunt for the best stacked deal

寻找最优叠加优惠

bash
dominos-pp-cli deals best --agent
Tries every available deal — including 2-3 deal stacked combinations — against the active cart and reports the lowest-priced combination plus the deal codes.
bash
dominos-pp-cli deals best --agent
尝试将所有可用优惠(包括2-3种优惠叠加组合)应用于当前购物车,并报告最低价格组合及优惠代码。

Watch a delivery in real-time

实时跟踪配送状态

bash
dominos-pp-cli track --phone 2065551234 --watch --interval 30s --agent
Streams status transitions every 30 seconds (placed → prep → bake → qc → out → delivered) until the order arrives. Exits 0 on delivered.
bash
dominos-pp-cli track --phone 2065551234 --watch --interval 30s --agent
每30秒流式输出状态变化(已下单 → 准备中 → 烘焙中 → 质检 → 配送中 → 已送达),直到订单完成配送。订单送达后退出码为0。

Why is this deal not applying to my cart?

为什么该优惠不适用于我的购物车?

bash
dominos-pp-cli deals eligible --agent
Lists deals against the active cart and explains eligibility against each deal's predicates.
bash
dominos-pp-cli deals eligible --agent
列出适用于当前购物车的优惠,并解释每个优惠的适用条件及不适用原因。

Auth Setup

认证设置

Most commands work without authentication: store locator, menu browse, cart building, anonymous order placement, and tracking-by-phone all succeed unauthenticated. For loyalty rewards, member-exclusive deals, and order history, run
dominos-pp-cli auth login
— it spawns a Chrome window pointed at dominos.com sign-in, waits for you to complete a normal login (handles captcha and 2FA), then reads the bearer token from sessionStorage and saves it to
~/.config/dominos-pp-cli/config.toml
. The token persists until Domino's expires it (~1 hour). Run
auth status
to confirm;
auth logout
to clear.
Run
dominos-pp-cli doctor
to verify setup.
大多数命令无需认证即可使用:门店定位、菜单浏览、购物车创建、匿名下单和按电话号码跟踪订单均支持未认证访问。如需使用会员奖励、会员专属优惠和订单历史功能,请执行
dominos-pp-cli auth login
——该命令会启动指向dominos.com登录页面的Chrome窗口,等待您完成正常登录(支持验证码和双因素认证),然后从sessionStorage中读取Bearer令牌并保存到
~/.config/dominos-pp-cli/config.toml
中。令牌会持续有效直到Domino's将其过期(约1小时)。执行
auth status
可确认认证状态;执行
auth logout
可清除令牌。
执行
dominos-pp-cli doctor
可验证设置是否正确。

Agent Mode

Agent模式

Add
--agent
to any command. Expands to:
--json --compact --no-input --no-color --yes
.
  • Pipeable — JSON on stdout, errors on stderr
  • Filterable
    --select
    keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
    bash
    dominos-pp-cli stores get mock-value --agent --select id,name,status
  • Previewable
    --dry-run
    shows the request without sending
  • Non-interactive — never prompts, every input is a flag
  • Explicit retries — use
    --idempotent
    only when an already-existing create should count as success
在任何命令后添加
--agent
参数。该参数等价于:
--json --compact --no-input --no-color --yes
  • 可管道化 — 标准输出为JSON格式,错误信息输出到标准错误流
  • 可筛选
    --select
    参数可保留指定字段。点路径可深入嵌套结构;数组会遍历所有元素。对于冗长的API,该参数可有效缩小上下文范围:
    bash
    dominos-pp-cli stores get mock-value --agent --select id,name,status
  • 可预演
    --dry-run
    参数会显示请求内容但不会发送
  • 非交互式 — 从不提示用户,所有输入均通过参数传递
  • 显式重试 — 仅当已存在的创建操作应被视为成功时,使用
    --idempotent
    参数

Agent Feedback

Agent反馈

When you (or the agent) notice something off about this CLI, record it:
dominos-pp-cli feedback "menu sync skipped nutrition fields for half the items"
dominos-pp-cli feedback --stdin < notes.txt
dominos-pp-cli feedback list --json --limit 10
Entries are stored locally at
~/.dominos-pp-cli/feedback.jsonl
. They are never POSTed unless
DOMINOS_FEEDBACK_ENDPOINT
is set AND either
--send
is passed or
DOMINOS_FEEDBACK_AUTO_SEND=true
. Default behavior is local-only.
Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.
当您(或Agent)发现该CLI存在问题时,可记录反馈:
dominos-pp-cli feedback "菜单同步时跳过了半数商品的营养字段"
dominos-pp-cli feedback --stdin < notes.txt
dominos-pp-cli feedback list --json --limit 10
反馈条目会本地存储在
~/.dominos-pp-cli/feedback.jsonl
中。仅当设置了
DOMINOS_FEEDBACK_ENDPOINT
环境变量,且添加了
--send
参数或设置
DOMINOS_FEEDBACK_AUTO_SEND=true
时,反馈才会被发送。默认行为为仅本地存储。
请描述令您感到意外的内容,而非提交 bug 报告。简短、具体、单行描述:这类反馈会逐步积累价值。

Output Delivery

输出投递

Every command accepts
--deliver <sink>
. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:
SinkEffect
stdout
Default; write to stdout only
file:<path>
Atomically write output to
<path>
(tmp + rename)
webhook:<url>
POST the output body to the URL (
application/json
or
application/x-ndjson
when
--compact
)
Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.
每个命令都支持
--deliver <sink>
参数。输出会发送到指定的sink,同时(或替代)输出到标准输出,以便Agent无需手动管道即可路由命令结果。支持三种sink:
Sink效果
stdout
默认值;仅输出到标准输出
file:<path>
原子性地将输出写入
<path>
(先写入临时文件再重命名)
webhook:<url>
将输出内容POST到指定URL(
application/json
格式;如果使用
--compact
参数则为
application/x-ndjson
格式)
不支持的协议会返回结构化错误,并列出支持的协议类型。Webhook请求失败时返回非零退出码,并在标准错误流中记录URL和HTTP状态码。

Named Profiles

命名配置文件

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.
dominos-pp-cli profile save briefing --json
dominos-pp-cli --profile briefing stores get mock-value
dominos-pp-cli profile list --json
dominos-pp-cli profile show briefing
dominos-pp-cli profile delete briefing --yes
Explicit flags always win over profile values; profile values win over defaults.
agent-context
lists all available profiles under
available_profiles
so introspecting agents discover them at runtime.
配置文件是一组保存的参数值,可在多次调用中复用。当定时Agent每次运行都使用相同配置调用同一命令时,可使用该功能——即HeyGen的“Beacon”模式。
dominos-pp-cli profile save briefing --json
dominos-pp-cli --profile briefing stores get mock-value
dominos-pp-cli profile list --json
dominos-pp-cli profile show briefing
dominos-pp-cli profile delete briefing --yes
显式参数优先级高于配置文件值;配置文件值优先级高于默认值。
agent-context
会在
available_profiles
下列出所有可用配置文件,以便Agent在运行时发现。

Exit Codes

退出码

CodeMeaning
0Success
2Usage error (wrong arguments)
3Resource not found
4Authentication required
5API error (upstream issue)
7Rate limited (wait and retry)
10Config error
代码含义
0成功
2使用错误(参数错误)
3资源未找到
4需要认证
5API错误(上游问题)
7速率限制(请等待后重试)
10配置错误

Argument Parsing

参数解析

Parse
$ARGUMENTS
:
  1. Empty,
    help
    , or
    --help
    → show
    dominos-pp-cli --help
    output
  2. Starts with
    install
    → ends with
    mcp
    → MCP installation; otherwise → see Prerequisites above
  3. Anything else → Direct Use (execute as CLI command with
    --agent
    )
解析
$ARGUMENTS
的规则:
  1. 为空、
    help
    --help
    → 显示
    dominos-pp-cli --help
    输出
  2. install
    开头
    → 如果结尾为
    mcp
    → 安装MCP;否则 → 参见顶部的前提条件
  3. 其他情况 → 直接使用(添加
    --agent
    参数执行CLI命令)

MCP Server Installation

MCP服务器安装

  1. Install the MCP server:
    bash
    go install github.com/mvanhorn/printing-press-library/library/food-and-dining/dominos/cmd/dominos-pp-mcp@latest
  2. Register with Claude Code:
    bash
    claude mcp add dominos-pp-mcp -- dominos-pp-mcp
  3. Verify:
    claude mcp list
  1. 安装MCP服务器:
    bash
    go install github.com/mvanhorn/printing-press-library/library/food-and-dining/dominos/cmd/dominos-pp-mcp@latest
  2. 在Claude Code中注册:
    bash
    claude mcp add dominos-pp-mcp -- dominos-pp-mcp
  3. 验证安装:
    claude mcp list

Direct Use

直接使用

  1. Check if installed:
    which dominos-pp-cli
    If not found, offer to install (see Prerequisites at the top of this skill).
  2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
  3. Execute with the
    --agent
    flag:
    bash
    dominos-pp-cli <command> [subcommand] [args] --agent
  4. If ambiguous, drill into subcommand help:
    dominos-pp-cli <command> --help
    .
  1. 检查是否已安装:
    which dominos-pp-cli
    如果未找到,提供安装选项(参见顶部的前提条件)。
  2. 将用户查询与上述独特功能和命令参考中的最佳命令匹配。
  3. 添加
    --agent
    参数执行命令:
    bash
    dominos-pp-cli <command> [subcommand] [args] --agent
  4. 如果存在歧义,查看子命令帮助:
    dominos-pp-cli <command> --help