agent-slack 是一个从终端读写 Slack 的命令行工具，特点是 JSON 输入、JSON 输出、无交互；列表采用 NDJSON（每行一个对象，末尾附 @pagination、@referenced_users 等元数据行）。
主要能力：读取消息、线程、频道历史与未读；通过永久链接、#频道 或用户 ID 定位目标；搜索消息与文件，文件命中会自动下载并返回本地路径；发送消息、回复线程、添加表情回应、编辑或删除消息、按下应用卡片按钮；管理用户、频道、子团队、自定义表情；获取画布为 Markdown；发现并运行 Slack 工作流；查询稍后读列表；还提供原始 API 调用的逃生通道。
认证方式：agent-slack auth import-desktop（推荐，无需退出 Slack Desktop）或 agent-slack auth import-browser firefox（支持 chrome|brave|firefox|zen|opera|safari），随后用 agent-slack auth test 验证；多工作区可用 --workspace 指定，或通过 SLACK_TOKEN 等环境变量覆盖。凭证导入失败时可用 agent-slack auth add --workspace-url <url> --form 由本人在系统弹窗中输入令牌，不应将令牌粘贴到对话中。
典型用法示例： agent-slack message get "<permalink>" agent-slack message list "#general" --limit 25 agent-slack search messages "deploy failed" --channel "#ops" --after 2026-06-01 agent-slack message send "#general" "ship it :rocket:" agent-slack message await "#team" --since "$ts" --events message,reaction --timeout 30m
等待回复时可用 message await（超时不算错误，返回 received:false 与游标）或 message stream 在后台持续监听；对话建议用 --conversation <root ts> 保持同一线程根，--since 应始终使用上一次结果的游标。
安全限制：可自由读取和搜索；除非用户明确要求，不要发送、编辑、删除、回应、定时、邀请或创建频道、按应用按钮、增删表情。破坏性命令（message edit|delete、message action、message draft delete、message scheduled cancel、channel new|invite、emoji add|remove）需要 --yes，否则只会返回将要发生什么的描述。错误以单个 JSON 对象输出到 stderr，含 fixable_by 字段（agent/human/retry）提示如何修复。具体平台支持与收费情况暂未提供。