安装
curl -fsSL aimaestro.sh | bash适合谁
- 适合同时使用多个 AI 编码代理（如 Claude Code、Codex、Grok Build 等）的开发者，想在一个网页仪表盘中统一管理这些代理会话，而不是在多个终端间切换。
- 适合希望代理具备记忆搜索、代码图谱查询、代理间消息通信等扩展能力的用户。
- 使用前提：需要在本机通过一条 shell 命令完成安装；由于应用本身没有应用层鉴权，必须只在可信网络（如 Tailscale 内网）内使用，端口 23000 不能暴露到不可信网络。若你无法保证网络边界，或不接受这种安全模型，则不适合使用。
- 官方证据未说明支持的操作系统最低要求、代理版本要求，这些信息目前未知。
3 分钟完成第一次尝试
推荐主路径是官方文档给出的远程 shell 安装：
curl -fsSL aimaestro.sh | bash
- 前提：一台可运行 shell 的机器，且处于你可控的可信网络内。
- 安装：在终端执行上面的命令。它会运行官方的 remote-install 脚本。注意：这是从网络下载并执行脚本的操作，安装前请确认你信任该来源。
- 安装后：启动后它提供基于 Web 的终端界面，通过 tmux 管理各 AI 代理会话（xterm.js 终端 + node-pty + WebSocket 流式输出）。
- 第一次尝试建议选一个低风险任务：在仪表盘中打开一个已有代理会话，让它做一次只读分析，例如总结某个代码文件的结构。具体某个代理支持哪些任务取决于该代理本身，官方证据未列明。
- 成功信号：在浏览器中能看到该代理的终端会话实时输出，并且代理给出分析结果。仪表盘能同时显示多个代理会话也说明编排生效。
官方还提到可以从一个仪表盘管理多个代理，但未说明其他安装方式，本指南只保留上述这一条官方路径。
使用案例
案例一：统一查看多个代理会话。 场景：你同时在跑 Claude Code 和另一个代理，想在同一界面查看它们。 做法：安装并启动后，在浏览器打开仪表盘，把要管理的代理会话接入（官方说明它通过 tmux 管理会话）。可期待结果：在一个 Web 界面中通过 xterm.js 终端看到各会话的实时输出。
案例二：让代理做一次只读代码分析。 场景：想验证编排环境可用，同时不想让代理改动任何文件。 做法：在仪表盘中向某个代理发出指令，例如"分析 src 目录下一个文件的结构并总结"。会使用的能力：仪表盘的终端会话本身；至于是否调用记忆搜索或代码图谱查询，取决于该代理装载的技能，官方证据未说明默认装载情况。可期待结果：代理在终端中输出分析文本；若无文件修改类操作，属于可撤销的观察型任务。
使用边界
- 网络：应用默认绑定 0.0.0.0 且无应用层鉴权，安全模型是"网络即信任边界"，官方要求配合 Tailscale 等网络边界使用，端口 23000 不得暴露到不可信网络。
- 副作用与确认点：安装会执行远程脚本；代理会话可能执行命令或访问文件，具体行为取决于所接代理，官方证据未说明本应用对代理操作的额外限制，未知信息不得当作"无风险"。
- 运行环境：需要 tmux 与支持 WebSocket 的浏览器；官方证据未列明操作系统要求。
- 官方明确限制：无应用级鉴权是设计决定，不是可配置选项的证据。
- 尚未确认：支持的文本/代理语言范围、支持的客户端完整列表、升级与卸载方式，官方证据均未说明。