Harnss：多 AI 编程代理桌面客户端

项目简介

Harnss 是一个跨平台桌面应用（基于 Electron），提供统一界面来运行、管理和切换多个 AI 编程代理，例如 Claude Code、Codex，以及所有兼容 Agent Client Protocol（ACP）的代理。每个会话拥有独立的状态、历史与上下文，切换代理时不必重启终端，也不会丢失上下文。

项目采用 MIT 许可证开源，源码主要使用 TypeScript 编写。

主要功能

• 多引擎会话：通过 Anthropic SDK 运行 Claude Code，通过 JSON-RPC app-server 运行 Codex，也可运行任意兼容 ACP 的代理，并支持并行会话、即时切换。
• 丰富的工具调用可视化：每次工具调用都以交互卡片呈现；文件改动展示词级 diff 与语法高亮，bash 输出内联显示，子代理任务以嵌套步骤展示进度，并按轮次汇总变更。
• MCP 服务器管理：按项目接入 MCP 服务器，支持 stdio、SSE、HTTP 三种传输方式，自动处理 OAuth 流程并持久化令牌，可查看服务器状态与可用工具数量。
• Git 集成：在应用内暂存、取消暂存、提交与推送，浏览分支与提交历史，管理 git worktree，并可基于暂存 diff 生成提交信息。
• 内置终端与浏览器：多标签 PTY 终端由本地 shell 进程驱动，内置浏览器可内联打开 URL 并为代理补充上下文，两个面板在工作期间保持挂载。
• 项目工作区与 Spaces：项目对应磁盘文件夹，Spaces 可用自定义图标与颜色对项目分组，会话、历史与面板设置均按项目隔离。
• Agent Store：在应用内浏览并安装 ACP 社区注册表中的代理，也可通过指定命令、参数、环境变量与图标添加自定义代理，无需手写配置文件。
• 计划模式与权限控制：计划模式让代理先产出方案再动手；提供 Ask First、Accept Edits、Allow All 三档权限，可随时切换而不打断上下文。
• 后台任务代理：会话中派生的任务代理可在后台继续运行并在专门面板中跟踪。
• 图片附件与标注：在对话中附加截图或图片，内置标注工具支持手绘、高亮与标记。
• 语音输入与通知：支持 macOS 原生听写或本地 Whisper 模型（无需 API Key），可为计划审批、权限请求、代理提问与会话完成配置系统通知。
• 会话搜索与历史：对会话标题与消息内容做全文检索，并可导入、恢复此前在 Claude Code CLI 中开始的对话。

安装与使用

从 Releases 页面 下载对应平台的安装包：

平台	下载
macOS (Apple Silicon)	.dmg（arm64）
macOS (Intel)	.dmg（x64）
Windows (x64)	.exe 安装程序
Windows (ARM64)	.exe 安装程序
Linux	.AppImage / .deb

快速开始：

1. 下载并安装对应平台的最新版本；
2. 打开一个项目，指向磁盘上的任意文件夹；
3. 选择引擎（Claude Code、Codex 或已安装的 ACP 代理）开始工作。

从源码运行：

git clone https://github.com/OpenSource03/harnss.git
cd harnss
pnpm install
pnpm dev

构建安装包：

pnpm dist:mac      # macOS DMG (arm64 + x64)
pnpm dist:win      # Windows NSIS installer (x64 + ARM64)
pnpm dist:linux    # Linux AppImage + deb

各引擎的前置条件：Claude Code 需要 Claude 账号（订阅或 API Key）；Codex 需要 PATH 中存在 Codex CLI，并具备 OpenAI API Key 或 ChatGPT 账号；ACP 代理的要求视具体代理而定，可在应用内的 ACP Agent Registry 安装或手动配置。

添加代理的入口是 Settings → ACP Agents：Agent Store 标签页用于浏览、安装社区注册表中的代理，My Agents 标签页用于创建自定义代理，或粘贴 JSON 定义自动填充表单。MCP 服务器则在右侧工具栏的 MCP Servers 面板中按项目配置。

注意事项

• 项目处于早期开发阶段，README 明确说明正在筹备一次较大规模的重写以提升可用性、性能与代码质量，使用中可能遇到问题，可在 Issues 中反馈。
• 预编译二进制目前未签名：macOS 首次启动需右键点击应用并选择「打开」以绕过 Gatekeeper 提示；Windows 若 Defender 报警，点击「更多信息 → 仍要运行」。
• 语音输入中的原生听写仅限 macOS，本地 Whisper 模型则无需 API Key。

---

本作品整理自 GitHub 开源项目 OpenSource03/harnss，原作者 @OpenSource03，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。