用途:wt 用于管理 LlamaFarm 的隔离开发环境。它基于 git worktree,为每个工作树分配独立的服务、端口和数据目录,使多个并行会话或智能体互不干扰,也便于在不影响主开发环境的情况下测试改动。
主要能力:创建并启动工作树(wt create feat/my-feature,加 --go 可创建后进入目录);列出工作树及状态(wt list);查看服务健康(wt status 或 wt health);启停服务(wt start / wt stop);查看日志(wt logs [server|rag|runtime|designer|all]);删除工作树(wt delete <name>);切换(wt switch <name>);浏览器打开 Designer(wt open);诊断问题(wt doctor);清理孤立数据(wt gc);清理已合并分支的工作树(wt prune);查看服务 URL(wt url)。
使用方式:新任务建议用 wt create --go,它会处理分支、依赖、构建与服务。创建前先用 wt list 查看已有工作树,运行测试或调用 API 前用 wt status 确认服务健康,遇到异常服务问题运行 wt doctor,任务完成后用 wt delete 释放资源。
环境细节:工作树位于 ~/worktrees/llamafarm/,数据目录为 ~/.llamafarm/worktrees/<name>/,日志在 ~/.llamafarm/worktrees/<name>/logs/。端口按工作树名称的确定性哈希分配(14345+offset、5000+offset、11000+offset)。若 Caddy 代理运行,可用 http://server.<name>.localhost 等免端口 URL。
限制:资料未提供安装方式、依赖要求、收费与平台支持等信息。