面向多 Agent 编排的本地优先 IDE，支持在同一界面中调度 Claude Code 和 OpenAI Codex，提供基于 Git Worktree 的隔离工作区管理、内置代码审查及 PR/MR 闭环能力，所有数据本地存储。
定位与核心价值#
Helmor 解决传统开发工具在 AI 编码时代面临的上下文割裂问题：开发者需在不同终端或窗口中频繁切换以协调多个 AI 编码 Agent，且难以对 Agent 产出进行结构化代码审查与 Git 工作流闭环。其能力边界聚焦于本地 Agent 调度与工作区管理，不提供云端算力或模型训练。
多 Agent 编排与调度#
- 深度集成 Claude Code CLI (Anthropic) 与 OpenAI Codex CLI，通过 Sidecar 进程以 SDK 方式调用，支持流式消息传输
- 支持 Claude Code 2.0 与 Codex 1.0 版本
- 支持 Codex 的
/goal及 thread/goal/* JSON-RPC API，含 token budget 管理 - 支持自定义 Provider（如内置 DeepSeek V4 Pro/Flash 作为 Claude Code 自定义 Provider）
工作区与 Git 工作流闭环#
- 基于 Git Worktree 提供完全隔离的独立工作区，支持分支切换、工作区归档与恢复、PR/MR 关联
- 内置 Review changes 功能，支持配置独立审查模型、effort level 及 fast-mode
- 应用内直接创建与合并 GitHub PR 和 GitLab MR
- 支持多 Forge 多账户绑定（v0.13.0+），自动为每个仓库匹配有权限的 GitHub/GitLab 账户
本地优先与安全机制#
- 所有数据存储于本地 SQLite 数据库（发布版
~/helmor/，调试版~/helmor-dev/），不依赖云端后端 - API Key 通过本地 CLI 管理，不经过任何第三方代理
IDE 基础体验#
- 内置多标签页终端（右侧 Inspector 面板）
- 内置文件浏览器与 Monaco 代码编辑器
- 四套颜色主题：Midnight、Forest、Ember、Aurora
架构要点#
三进程模型：
- Frontend：React 19 + Vite + TypeScript + Tailwind CSS v4，运行于 Tauri webview，使用 TanStack React Query、Lexical、Monaco、shadcn/ui (base-nova)
- Rust Backend：Tauri v2 + Rust + SQLite，负责数据库、Sidecar 管理、Git 操作、GitHub/GitLab 集成、MCP bridge 及消息管道
- Sidecar：Bun + TypeScript，封装
@anthropic-ai/claude-agent-sdk和@openai/codex-sdk，编译为独立二进制，通过 stdin/stdout JSON 事件流与 Rust 后端通信
核心消息流：
用户输入 → Rust agents::streaming → sidecar → SDK → stdout events
→ Rust accumulator → adapter + collapse → ThreadMessageLike[]
→ tauri::ipc::Channel → React UI
Rust 后端关键模块： commands/（IPC 命令）、agents/（流式传输与持久化）、pipeline/（消息管道）、workspace/（工作区生命周期）、git/（Git 操作）、github/（GitHub/GitLab 认证与 GraphQL）、models/（SQLite 持久化）、mcp.rs（MCP bridge）
测试体系： Vitest + jsdom（前端）、bun test（sidecar）、cargo test + insta 快照测试（Rust，70+ pipeline 场景）
安装与上手#
- 从官网或 GitHub Releases 下载 macOS DMG（ARM ~206.7 MB / x64 ~224.0 MB），已签名公证
- 启动后导入本地项目或连接 GitHub/GitLab 账户，在设置面板安装内置 Claude Code 和 Codex CLI
- 源码构建：
bun install && bun run dev（需 bun 1.3+）
环境变量： HELMOR_DATA_DIR（数据目录）、HELMOR_LOG（日志级别）、VITE_HELMOR_PERF_HUD=1（性能 HUD）
当前限制#
- 仅支持 macOS（Apple Silicon + Intel，macOS 12+），Windows/Linux 支持待确认
- Agent SDK 版本升级需手动更新 SHA256 校验