用途：ArchDev 的 agents 命令用于在 Git 仓库中搭建并运行编码智能体，支持启动、恢复和停止会话，运行工作流或 Factory，查看自定义定义，以及管理 worktree 与本地工作。agents 是 ArchDev CLI 命名空间，不是 ArchAgents 平台智能体的创建/部署 API。
主要能力与用法：
- 引导：通过 bash scripts/bootstrap.sh（Fish 用 set、PowerShell 用对应 ps1）取得可执行文件绝对路径，并安装或升级缺失的 Agents/provider 命令。
- 连接账号与模型：进入目标 Git 仓库运行 "$archdev" agents setup 完成仅智能体的引导；可交互选择 provider，或使用 agents setup --provider openai --provider-email <email>；xai 对应 Grok，archdev 为模型路由。设置选择器为 archdev，该路由的模型 provider 标识为 platform。需区分 ArchDev 身份登录与自带模型凭据，自带模型不解除账号登录要求。用 --model <selector> 或 TUI 内 /model 明确选择模型。
- 执行模式：交互会话 agents start [prompt]；单次无头请求 agents run <prompt> --output-format json；无头续跑 agents run <prompt> --resume <session-id>；恢复 TUI agents resume <session-id>；运行命名工作流 agents workflows run <name>；启动 Factory agents factory run [--workers <n>]。
- 管理：agents sessions list/show/stop、agents definitions list/show、agents worktrees create/remove、agents work list/show/clean。
限制与注意：无头命令可能改文件，应使用预期检出；权限按用户授权选择，不要常规启用 bypass 模式；解析最终结果时关注 session_id、is_error、result 并检查退出状态；交互会话需在真实终端或持久 PTY 中运行；仅在被要求时启用 Factory，注册会带来 Jobs 副作用；不要把凭据写入提交、日志或提示。资料未提供价格、平台完整清单与效果数据。