Agentmux

Agentmux

Agentmux 是面向 Codex 与 Claude Code 的本地配置管理器。桌面端是主要入口，可统一管理预设、模型、认证、MCP、Skills、历史会话与配置备份。

所有数据保存在本机。Agentmux 不托管远程服务，也不会上传配置或凭据。

桌面端

支持平台

平台	安装包
macOS Apple Silicon	DMG
Windows x64	NSIS 安装程序

macOS Intel 暂不支持。Linux 当前仅提供可选 CLI。

安装

从 [GitHub Releases](https://github.com/zhanyoulin456/agentmux/releases/latest) 下载对应平台的桌面安装包并安装。

桌面安装包已经内置 Agentmux sidecar，**不需要再安装 `amux` 命令行工具**。你仍需安装准备使用的 Agent 客户端：

• Codex CLI
• Claude Code

设置页会显示本机是否找到 `codex` 与 `claude`。会话页复制的恢复命令也需要对应客户端可用。

功能

• 为 Codex 与 Claude Code 分别维护模型、接口和认证预设。
• 全局管理 HTTP / STDIO MCP，并绑定到指定预设。
• 导入 Skills，并控制各预设的绑定关系。
• 查询本地历史会话，按项目和更新时间筛选，复制恢复命令。
• 启用预设前自动备份原生配置，支持回滚最近快照。
• 支持深色、浅色和跟随系统主题。
• 在设置页检查新版本并前往 GitHub Release 下载。

首次使用

1. 打开 Agentmux，在右上角选择 Codex 或 Claude。
2. 从本机原生配置导入 MCP，或手动新增 MCP。
3. 导入需要统一管理的 Skills。
4. 新建预设，填写模型接口并绑定 MCP、Skills。
5. 启用预设。Agentmux 会先备份，再写入对应 Agent 的原生配置。

预设与启用状态按 Agent 独立保存。切换 Agent 不会覆盖另一端的配置。

配置模型

                         +-- MCP 定义（全局保存一次）
Codex / Claude -- 预设 --+
                         +-- Skill 索引（统一目录）
        |
        +-- 启用：写入 Agent 原生配置
        +-- 回滚：恢复最近配置快照

• 预设：模型供应商、模型、认证引用以及绑定的 MCP、Skills。
• MCP：全局定义一次，通过目标 Agent 和预设绑定决定是否启用。
• Skill：Agentmux 负责导入、索引和绑定，不编辑 Skill 内容。

Agentmux 声明配置是维护入口，Codex / Claude 的原生配置是运行时投影。不要同时使用其他配置管理器修改同一 Agent 的受管字段；需要接收外部修改时，重新执行导入。

可选 CLI

桌面用户不需要安装 CLI。以下场景可选择安装：

• 在脚本或 CI 中管理配置。
• 使用 amux run 临时启动指定预设。
• 在终端执行批量绑定、导入或诊断。

CLI 支持 macOS Apple Silicon、Linux x64 与 Windows x64，发布包不依赖 Bun。

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/zhanyoulin456/agentmux/main/scripts/install.sh | sh

默认安装到 `~/.local/bin/amux`。指定版本或安装目录：

curl -fsSL https://raw.githubusercontent.com/zhanyoulin456/agentmux/main/scripts/install.sh | \
  AGENTMUX_VERS