Helmor

Positioning & Core Value#

Helmor addresses the context fragmentation problem in the AI coding era: developers frequently switch between terminals/windows to coordinate multiple AI coding Agents, and struggle with structured code review and Git workflow closure on Agent outputs. Its capability boundary focuses on local Agent scheduling and workspace management, not cloud compute or model training.

Multi-Agent Orchestration#

• Deep integration with Claude Code CLI (Anthropic) and OpenAI Codex CLI via Sidecar process using SDK calls, with streaming message support
• Supports Claude Code 2.0 and Codex 1.0
• Supports Codex /goal and thread/goal/* JSON-RPC API with token budget management
• Custom Provider support (e.g., built-in DeepSeek V4 Pro/Flash as Claude Code custom Provider)

Workspace & Git Workflow Closure#

• Fully isolated workspaces based on Git Worktree, with branch switching, workspace archive/restore, PR/MR association
• Built-in Review changes with independent review model, effort level, and fast-mode configuration
• Create and merge GitHub PRs and GitLab MRs directly in-app
• Multi-forge multi-account binding (v0.13.0+) with automatic permission matching per repository

Local-First & Security#

• All data stored in local SQLite (release: ~/helmor/, debug: ~/helmor-dev/), no cloud backend dependency
• API Keys managed via local CLI, no third-party proxy

IDE Experience#

• Multi-tab terminal (right Inspector panel)
• Built-in file browser and Monaco code editor
• Four color themes: Midnight, Forest, Ember, Aurora

Architecture#

Three-Process Model:

• Frontend: React 19 + Vite + TypeScript + Tailwind CSS v4 in Tauri webview, using TanStack React Query, Lexical, Monaco, shadcn/ui (base-nova)
• Rust Backend: Tauri v2 + Rust + SQLite — database, Sidecar management, Git ops, GitHub/GitLab integration, MCP bridge, message pipeline
• Sidecar: Bun + TypeScript wrapping @anthropic-ai/claude-agent-sdk and @openai/codex-sdk, compiled as standalone binary, communicates with Rust backend via stdin/stdout JSON event streams

Core Message Flow:

User Input → Rust agents::streaming → sidecar → SDK → stdout events
→ Rust accumulator → adapter + collapse → ThreadMessageLike[]
→ tauri::ipc::Channel → React UI

Key Rust Modules: commands/ (IPC), agents/ (streaming & persistence), pipeline/ (message pipeline), workspace/ (workspace lifecycle), git/ (Git ops), github/ (auth & GraphQL), models/ (SQLite persistence), mcp.rs (MCP bridge)

Testing: Vitest + jsdom (frontend), bun test (sidecar), cargo test + insta snapshots (Rust, 70+ pipeline scenarios)

Installation & Quick Start#

• Download macOS DMG from official site or GitHub Releases (ARM ~206.7 MB / x64 ~224.0 MB), signed & notarized
• Import local project or connect GitHub/GitLab account, install bundled Claude Code and Codex CLI from settings
• Source build: bun install && bun run dev (requires bun 1.3+)

Env Vars: HELMOR_DATA_DIR, HELMOR_LOG, VITE_HELMOR_PERF_HUD=1

Current Limitations#

• macOS only (Apple Silicon + Intel, macOS 12+), Windows/Linux support unconfirmed
• Agent SDK version upgrades require manual SHA256 checksum updates