alera-cli

Alera CLI

使用托管的 alera CLI 管理 Alera 资源。在 Alera 终端中，其 shim 和 ALERA_RUNTIME_DIR 会选择 UI 的运行时配置文件。使用命令组的 --help 查看标志，使用 --json 获取结构化输出；列表封装使用 items。

选择相关工作流

• 项目、工作树、移交/接管、关联问题、Watch and Fix、标签、标签页、关系和分区：阅读 workspaces。
• SSH 目标和远程工作区设置：阅读 hosts。
• 定时 Agent 工作：使用 alera-automations 技能；CLI 入口见 automations。
• 缺少运行时主机、外部 shell 配置、元数据修复，或标签页不再显示其 Agent 状态：阅读 recovery。
• Agent Profile 检查、启动或维护：使用 alera-agent-profiles 技能。其简单维护路径无需研究目录。
• 从终端外向正在运行的 Agent 提问，或读取收件箱：阅读 inbox。
• Agent 调度、工作任务或协调器生命周期：使用 alera-orchestration 技能。
• 将运行时登录到 Alera 账户、为其命名，或让 MCP 客户端驱动它（MCP Control、alera mcp serve）：阅读 mcp。
• 检查或更新此机器上为编码 Agent 安装的 Alera 技能：alera skill status 会将每项技能与此运行时进行比较，alera skill install [--skill <name>] 会将其安装到此运行时当前的提交版本。

仅加载当前请求所需的工作流。

工作区不变量

对实际托管的工作树使用 workspace add/remove。仅在有意修复元数据时使用 register/unregister；register --host-id 不会创建远程工作树。SSH 引导程序只安装 sidecar；workspace add --host-id 才会创建远程工作树。

除非用户要求进行低级恢复，否则不要使用原始的 git worktree add/remove，也不要编辑运行时元数据。执行破坏性操作前，先检查准确的 ID 和状态。保留用户创建的分支，除非用户明确要求删除；默认情况下，移除操作只会删除 Alera 创建的分支。使用 workspace rename 更改工作区的显示名称；它不会重命名分支或工作树文件夹。使用 workspace focus 在正在运行的桌面应用中选择并显示现有工作区；如果 Alera 未运行，该命令会失败，而不会启动 Alera。使用 workspace pin/unpin 调整侧边栏位置。使用 workspace section 指定侧边栏分区；不要通过编辑 runtime.sqlite 来指定分区。