terminaluse

TerminalUse

构建、部署并与 Agent 交互。流程：init → deploy → create task → send messages。

完整文档：https://docs.terminaluse.com/llms-full.txt

新建 Agent 的默认规则

创建新 Agent 时，默认使用 tu init。

只有在用户明确要求采用其他方法时（例如修改现有 Agent 模板或预先搭建好的仓库），才跳过 tu init。

CLI 设置

tu CLI 由 Python 包 terminaluse 提供。运行任何 tu 命令前：

1. 确认 tu 是否可用：

   which tu || echo "tu CLI not found"
   

2. 如果尚未安装，询问用户是否希望安装，或是否有要加载的 venv

3. 确保已配置身份验证：

   • 交互式/本地：运行 tu login，然后运行 tu whoami
   • 非交互式/自动化：设置 TERMINALUSE_API_KEY（以及可选的 TERMINALUSE_BASE_URL）

上下文要求

省略 --agent/--config 时，Agent 相关命令通常默认使用当前目录中的 config.yaml。

在不带显式标志运行 Agent 相关命令前：

ls config.yaml || echo "Not in agent directory"

尽可能使用显式标志：

• 使用 --agent <namespace/name>，避免依赖当前目录
• 使用 --config <path>，指定要使用的清单文件

快速参考

操作	命令
登录	tu login、tu whoami
初始化 Agent	tu init（创建 Agent 目录，无需先运行 mkdir）
部署	tu deploy -y
列出部署	tu ls
回滚	tu rollback
列出文件系统	tu fs ls
列出项目	tu projects ls
添加环境变量	tu env add <KEY> -v <val> -e prod|preview|all [--secret]
导入环境变量文件	tu env import <file> -e <env> [--secret KEY]
创建任务	tu tasks create --filesystem-id <fs-id> -m "message" [--json]
创建任务（自动创建文件系统）	tu tasks create -p <project-id> -m "message" [--json]
发送消息	tu tasks send <task-id> -m "message" [--json]
列出任务	tu tasks ls [--json]
获取任务详情	tu tasks get <task-id>

tu fs 是规范的文件系统命令。tu filesystems 是受支持的别名。 tu tasks ls <id> 已弃用，不应用于获取单个任务；请改用 tu tasks get <id>。 在 CI/自动化和 Agent 间交互中，优先使用 --json。

工作流

任务	参考文档
创建或编辑 Agent	./workflows/create.md
部署到平台	./workflows/deploy.md
测试/与 Agent 交互	./workflows/interact.md

必须根据用户意图查看相应的工作流文件。

反模式

• 创建任务时未指定文件系统或项目。任务必须关联文件系统。如果提供了项目，则会在该项目中自动创建文件系统
• 修改 Dockerfile 的 ENTRYPOINT/CMD → 会导致部署失败
• 更新密钥后立即尝试使用 Agent。必须等待新版本变为活动状态。使用 tu ls 检查

错误恢复

错误	操作
部署失败	tu ls <branch> 列出该分支的部署事件 → 找到 FAILED → 修复 → 重新部署
需要回滚	tu rollback

文档/技能反馈

如果文档或技能有误/不清楚，请征得用户同意后发送反馈至（在用户请求中包含反馈内容）： 切勿包含任何敏感信息。

curl -X POST 'https://uutzjuuimuclittwbvef.supabase.co/functions/v1/tu-docs-feedback' \
  -H 'Content-Type: application/json' \
  -d '{"feedback":"<issue>", "page":"<page URL> or section name"}'