AgentEnv Manager

English | 简体中文

AgentEnv Manager 用来统一管理多个 coding agent 的工作环境，主要功能包括：

• Profile 切换：组合 Instructions、Skills、Skill Groups 和 MCP 选择，再应用到本机或 SSH Linux 设备上的 Agent。
• Instructions 管理：把常用规则保存成可复用的内容块，在不同 Profile 中按顺序组合成 Agent 的指令文件。
• Skills 管理：从本地、ZIP、GitHub 或 Git 仓库导入 Skills，添加标签和分组，并持续检查来源更新。
• 项目环境：保存常用本地或 SSH Linux 项目目录，管理项目自己的 Instructions 和 Skills，并打开 Agent 或复制启动命令。
• 对话搜索：在一个入口搜索本机和 SSH 设备上的 Agent 历史，查看消息和完整项目路径。本地对话可以回到原 Agent，或交给另一个 Agent 续接。
• 应用前试用：预览 Profile 会带来的变化，用同一个任务对比当前环境和新 Profile，再决定是否应用。
• AI 辅助：看 Skill 更新摘要、生成标签建议，或分析 Profile 和运行对比结果；只在手动点击时调用你配置的 AI 服务。

它不会接管模型、账号、凭据或整份配置文件，只处理各 Agent 明确支持的 Instructions、Skills 和 MCP 开关。

以下截图均使用演示数据，运行对比结果由测试 CLI 生成。

安装

macOS 推荐使用官方 Homebrew Cask：

brew install --cask chroming/tap/agentenv-manager

更新已安装版本：

brew upgrade --cask chroming/tap/agentenv-manager

Homebrew 会按架构下载官方 Release、验证 SHA-256 并移除 quarantine。macOS、Windows 和 Linux 安装包也可以从 GitHub Releases 下载。

macOS 正式安装包使用项目固定的自签名身份，但没有 Developer ID 和公证。固定身份可让系统在升级时持续识别同一个应用；从浏览器直接下载时，仍需先把应用复制到“应用程序”并推出 DMG，再按 Apple 的说明 选择“仍要打开”。安装或升级后，macOS 可能要求输入登录密码，以授权当前应用访问 AgentEnv Manager 保存在系统钥匙串中的安全存储；这是 macOS 的系统提示，密码不会提供给 AgentEnv Manager。首次安装后，只要应用所在目录可写，Homebrew 和直接下载版本都可以在设置中检查、验证并安装更新；直接更新启动失败时会自动恢复旧版本。

第一次使用

1. 启动应用，确认自动检测到的 Agent。没有安装的 Agent 默认保持关闭；需要管理远程环境时，可以从 SSH 配置添加 Linux 设备。
2. 在 Agents 中配置一个 Agent，把当前设置和需要复用的用户 Skills 保存到 Profile 与 Library，或从空 Profile 开始。Agent 自带或插件提供的 Skills 会单独列出，仍由原 Agent 管理，不会自动导入 Profile。
3. 修改会自动保存到 Profile。查看 Apply 预览，确认变化后再写入 Agent。AgentEnv 会先创建恢复点，并在写入失败时尝试自动回滚。
4. 只有 Capture 或 Apply 发现相关的本地 Skill 需要确认时，才进入 Local Skills Manager。需要整理整台设备时，也可以从 Skills 页面主动打开它。

Profiles

Profile 保存一套可复用的 Agent 工作方式。你可以按顺序组合 Instructions，直接选择 Skills，或选择会持续跟随 Library 成员变化的 Skill Group；MCP 只保存受支持 Agent 中已有服务的启停选择。每类资源都可以使用 Profile 内容、关闭，或保留 Agent 当前状态。修改会自动保存到 AgentEnv，但不会自动写入 Agent。

Apply 前，AgentEnv 会重新读取目标环境，列出将新增、替换、删除、保留或需要确认的资源。只有确认后才会写入，并在完成后验证结果。

如果想放弃尚未 Apply 的修改，可以恢复到该 Agent 上次成功 Apply 的 Profile 版本。Profile 菜单中的 Recovery 也会保留最近的编辑历史。

Apply 前对比

Compare 会让当前 Agent 设置和候选 Profile 对同一个任务各运行一次，并排展示回复、文件变化、耗时和 CLI 明确上报的 token。

两次运行都使用隔离的临时 Home 和 Workspace，不会 Apply，也不会修改真实 Agent 或原项目。Compare 会消耗对应 Agent 的账号额度，目前仅支持 macOS。OpenCode、Claude Code、Codex、Antigravity CLI 和 Pi 已提供验证过的实现，Trae CLI 暂不支持可靠的一次性运行。

Instructions

Instruction Library 用来保存可复用的 Markdown 指令块。一个 Profile 可以引用多条 Instruction 并调整顺序，Apply 时再合成为目标 Agent 使用的指令文件。你可以从 Library 或 Profile 中打开同一套预览和编辑器；编辑前会显示受影响的 Profiles。

Workspace 中的项目指令仍由项目目录自己管理，不会自动连接到 Instruction Library。

Workspaces

Workspaces 保存常用本地或 SSH Linux 目录，并展示所选 Agent 在该目录可用的资源。你可以编辑受支持的 Instructions，把单个 Library Skill 或 Skill Group 当前启用的成员复制为项目文件。添加远程工作区时可以直接浏览远程目录，不必手写路径；本地和远程目录都能从 Quick Open 快速找到。

目录中的文件始终是唯一事实源。Workspace 不绑定 Profile，不创建 Library 链接，也不会替你 stage 或 commit Git 变化。Skill Group 在这里是一次选择模板，复制后不会把 Group 状态写进项目。移除 Workspace 只会删除应用内引用。明确修改 Workspace 资源时会保留恢复记录，可以撤销最近一次修改或从 Recovery 选择历史版本。

本地目录可用已安装的 Agent 打开；远程目录按 Agent 能力提供远程编辑器入口或可复制的 SSH 启动命令。

Skill Library

Library 为每个 Skill 保存一份可复用内容。可以从本地目录、ZIP、GitHub 路径或普通 Git 仓库导入，再通过 Profile 安装到各 Agent 的专属目录。标签可以按任务筛选 Skills；手动 Skill Group 可以把常用组合加入多个 Profile，并在 Group 成员变化时同步更新这些 Profile 的有效成员。

日常在 Skill list 中按标签和状态筛选，点击名称查看文件，点击更新状态预览变化。想查看整个来源目录时，再切到 By source。

按来源视图会显示同一仓库或目录中的新增、更新和删除，也支持合并来源、忽略条目和关闭更新检查。Groups 用来维护手动组合，整组关闭时会保留成员自己的开关状态。Local Skills 用来处理机器上已有的重复副本、内容冲突、失效链接和共享集合。所有清理动作都会先预览，并为改动保留恢复记录。

更新或添加来源中的 Skill 前，可以先看文件，再手动生成 AI 摘要，了解用途变化、兼容性和潜在风险。摘要按这次内容版本保存，重复查看不再调用 AI。标签分为自己维护的固定标签和 AI 建议；建议可按需更新，也可转为固定标签。

Conversations

首次进入 Conversations 时不会自动读取历史。在列表的“更多”菜单里打开“历史来源”，按设备开启本机或 SSH 历史搜索；只想收集部分 Agent 时，再从该设备的“更多”菜单调整。

可以搜索标题和消息，按设备、Agent、目录筛选，按最近聊天时间或文件大小排序。每条结果都能看到来源设备、Agent 和完整工作目录，列表同时显示当前结果占用的总大小。索引和刷新在后台进行，不必等全部读完才能操作。

索引只保存在本机；暂停后仍能搜索已有记录，关闭时可清除缓存，不会删除原始对话。设备离线或部分历史无法读取时，会保留已有结果并提示读取问题。搜索范围取决于已开启的来源和 Agent 支持的历史格式，并不等于设备上的所有聊天记录。

本地对话可以回到原 Agent 或交给另一个 Agent 续接。SSH 对话目前支持搜索、阅读和复制来源信息，暂不支持直接恢复会话；远端需要 Python 3。

日常浏览和搜索只读，不改原始会话。对支持迁移的 Agent，可以主动把会话迁移到另一个工作目录，并先预览影响。原始会话仍归对应 Agent 所有，不会加入 Profile 或 Device Sync。

支持的 Agents

• OpenCode
• Claude Code
• Codex（独立 CLI，或新版 ChatGPT 桌面端内置的 Codex）
• Antigravity CLI
• Antigravity 桌面端
• Trae CLI
• Pi Coding Agent
• WorkBuddy（管理用户 Skills；设置、Connector、Memory 和会话仍由 WorkBuddy 管理）

不同 Agent 支持的 Instructions、MCP、Conversations 和 Compare 能力并不完全相同。应用只显示当前 Agent 实际支持的操作。

Agent 的启用、排序、检测偏好和自定义路径都在 Agents 页面管理，不必再去设置里找。关闭一个 Agent 只会从日常操作中隐藏它，不会删除文件或停止接管；停止接管是独立操作。

Agents 页面还可以读取当前用户的 SSH 配置并添加 Linux 设备。远程 Profile Apply 使用系统 SSH，只管理适配器明确支持的远程 Instructions 和复制到远程目录的 Skills；远程 MCP 定义和凭据仍由对应 Agent 管理。

其他功能

• Device Sync 通过专用私有 Git 仓库同步可移植的 Profiles、Instruction Library、Skill Library 和手动 Skill Groups。拉取和发布都需要手动审核，不会自动 Apply。
• Recovery 包含 Apply、Profile 编辑、Workspace 修改、Skill 清理和同步产生的恢复记录，可以预览文件后再恢复。
• GitHub 登录为仓库导入和更新检查提供更高的 API 限额；普通 Git 和 SSH 仓库使用系统 Git 凭据。
• 界面支持 English、简体中文和繁體中文。

安全和隐私

• Profile 写入遵循 Preview、Backup、Apply、Verify 流程；没有语义变化时不会写文件。
• AgentEnv 只修改对应 Agent integration 明确声明可管理的文件或字段。MCP 定义和凭据仍由 Agent 保存。
• Repository 扫描使用独立缓存，不会修改已有 checkout。Device Sync 不同步凭据、Agent 状态、Backup 或本机绝对路径。
• AI 辅助需要在 Settings 配置服务地址、模型和 API Key。分析只在手动触发时发送相关内容，可能包含私有文件，并消耗该服务的额度；可关闭全部 AI 功能或单项功能。分析结果是参考，不是安全认证，也不会替你修改资源。
• 官方构建默认每天最多发送一次匿名安装信息，包括随机安装 ID、应用版本、操作系统类型及主版本、架构、界面语言和安装渠道。可以在 Settings 中关闭并预览完整字段。

完整行为见 产品契约，数据与网络访问说明见 PRIVACY.md。

从源码运行

需要 Node.js 22.12 或更高版本、npm 10 或更高版本，以及 Git。

npm ci
npm run dev

常用命令：

npm run test:quick       # 按当前改动运行相关测试
npm run verify:commit    # 提交前完整验证
npm run verify:release   # 打包应用与发布门禁
npm run dist:mac         # macOS 安装包
npm run dist:win         # Windows 安装包
npm run dist:linux       # Linux 安装包

开发文件操作时，请使用隔离的应用数据和 Agent Home。具体设置、架构、测试策略和发布流程见 开发文档。

参与项目

提交改动前请阅读 CONTRIBUTING.md。安全问题请按 SECURITY.md 私下报告。

AgentEnv Manager 使用 GNU General Public License v3.0。产品名称和标志归各自权利人所有，详见 THIRD_PARTY_NOTICES.md。本项目是独立项目，与上述 Agent 的开发者没有隶属或背书关系。