Tandoor Recipe CLI

Tandoor CLI Skill 该技能使 AI 代理可通过 tandoor-cli 命令行工具与 Tandoor Recipe Manager 实例交互。

前提条件 必须已安装并配置 tandoor-cli。若 tandoor -V 无有效版本，请参见 references/SETUP.md 中的安装说明。

调用 tandoor [options]

命令

Recipes

命令	描述
list [--limit N]	列出食谱（默认 20，最大 100）
search	按关键词搜索食谱
get	获取完整食谱详情
random	随机获取食谱
add [--json file]	创建食谱（交互或从 JSON）
update --json file	更新现有食谱
delete [--force]	删除食谱
import [--dry-run]	从 URL 导入食谱

Meal Plans

命令	描述
mealplan list [--startdate DATE] [--enddate DATE]	列出膳食计划（可按日期过滤）
mealplan add --recipe ID --date YYYY-MM-DD --meal-type N	添加膳食计划条目
mealplan delete	删除膳食计划条目

Shopping List

命令	描述
shopping list	列出购物清单
shopping add --food NAME --amount N --unit UNIT	添加购物项
shopping check [id]	勾选购物项（或 --all 全选）
shopping check --all	勾选全部
shopping clear [--force]	清空已勾选项

Households & Users 重要：Tandoor 用 household 组织用户与食谱；用户需通过邀请链接加入 household，无法直接通过 API 创建用户。 权限要求：管理 household 需特殊权限，多数操作需 admin/staff；household invite create 必须空间所有者认证，否则 403。遇权限错误请使用空间所有者 API token 或联系管理员。

命令	描述
household list	列出所有 household
household get	获取 household 详情
household add	新建 household（需 admin）
household edit --name	重命名 household（需 admin）
household delete [--force]	删除 household（需 admin）
household users list	列出空间内所有用户
household users memberships	列出用户-空间关系
household users assign	将用户分配到 household（需 admin）
household invite list	列出邀请链接（需 admin）
household invite create [--email EMAIL] [--expires DATE] [--group-id ID]	创建邀请链接（需空间所有者 token）
household invite delete [--force]	删除邀请链接（需 admin）

Food Ingredients

命令	描述
food list [--limit N] [--search TERM] [--ignored]	列出食材
food edit	name> --ignore-shopping	false>	修改食材 ignore_shopping 标志
food ignore	name> [--unset]	设置/取消 ignore_shopping
food onhand	name> [--unset]	设置/取消 on-hand 标志

所有读取命令支持 --json，输出机器可读格式，便于代理流水线使用。

配置 CLI 支持三种配置方式（优先级从高到低）：

• 环境变量：当前 shell 中的 TANDOOR_URL 与 TANDOOR_API_TOKEN
• 配置文件：~/.config/tandoor-cli/config.json（由 tandoor configure 生成）
• .env 文件：当前工作目录下的 .env

运行 tandoor configure 一次即可交互式保存凭据。

示例 配置凭据： tandoor configure

读取示例 — JSON 列出食谱： tandoor list --limit 5 --json

写入示例 — 从 JSON 创建食谱： tandoor add --json recipe.json

Household 示例 — 创建 household 并生成邀请链接：

tandoor household add "My Family"
tandoor household invite create 1 --email user@example.com --expires 2026-12-31

购物清单示例 — 添加并勾选：

tandoor shopping add --food flour --amount 500 --unit g
tandoor shopping check --all

参考 详见 references/SETUP.md 获取完整安装与认证配置文档。