用途:通过 Trello REST API 和 curl 管理 Trello 看板、列表与卡片,适合在命令行或智能体流程中查看看板、创建/移动/归档卡片、添加清单和截止日期。无需单独安装 CLI,仅需 curl(macOS/Linux 通常已预装)。
主要能力:列出所有看板、按名称查找看板 ID;获取看板下的列表、创建列表;获取列表中的卡片、创建卡片、移动卡片到其他列表、归档卡片、设置截止日期;为卡片添加清单及清单项。
使用方式:先设置凭据环境变量:export TRELLO_API_KEY="your_api_key" 和 export TRELLO_TOKEN="your_token"。API Key 从 https://trello.com/app-key 获取,Token 在该页面点击 Token 链接并授权。可将凭据存入 shell 配置文件(~/.zshrc 或 ~/.bashrc)或用 1Password 的 op run 注入。基础 URL 为 https://api.trello.com/1,认证参数为 key=$TRELLO_API_KEY&token=$TRELLO_TOKEN。常用命令示例:列出看板 curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[].name';创建卡片 curl -s -X POST "https://api.trello.com/1/cards?idList=<LIST_ID>&name=<NAME>&desc=<DESC>&key=$TRELLO_API_KEY&token=$TRELLO_TOKEN";移动卡片 curl -s -X PUT "https://api.trello.com/1/cards/<CARD_ID>?idList=<NEW_LIST_ID>&key=$TRELLO_API_KEY&token=$TRELLO_TOKEN";归档卡片加 closed=true;设置截止日期用 due 参数;添加清单用 /checklists 接口。
规则与限制:使用前检查 TRELLO_API_KEY 和 TRELLO_TOKEN 是否已设置,未设置则引导用户访问 https://trello.com/app-key 并停止;切勿记录或存储 API 密钥/令牌到内存或工作区文件;建议用 jq 格式化输出,必要时 brew install jq;查找看板/列表/卡片 ID 时先查询并在同一会话中缓存;名称和描述中的特殊字符需 URL 编码(空格转 +);回复保持简洁,确认操作并显示创建或更新的项目名称。其他收费、平台或效果信息暂未提供。