Summary

Helmor provides a local-first workbench for orchestrating multiple AI coding agents, streamlining the software development lifecycle from coding to shipping. It targets developers seeking to accelerate their workflow by parallelizing agent tasks, offering a unified interface for review, testing, and deployment, while ensuring code and credentials remain on the user's machine.

How It Works

Helmor operates by creating isolated Git worktrees and branches for each agent task, preventing conflicts and maintaining a clean main branch. It supports integrating various AI models (e.g., Claude Code, OpenAI Codex) via API keys, allowing users to select models and modes per message. The platform offers a unified interface for live output monitoring, mid-flight steering, side-by-side diff reviews, integrated terminals, and one-click actions for creating pull requests, merging, and resolving CI issues. Its local-first architecture ensures all code, sessions, and credentials reside on the user's machine, with data stored in a local SQLite database.

Quick Start & Requirements

• Primary install / run command: Download macOS (DMG) or Windows (setup installer) executables. Agent CLIs are bundled.
• Non-default prerequisites and dependencies: No external agent installations required for basic use. Building from source requires Bun 1.3+, Rust toolchain, and platform build tools (e.g., Xcode Command Line Tools on macOS).
• Links: Install Guide, User Guide, CLI & MCP.

Highlighted Details

• Isolated Workspaces: Each task runs in a dedicated Git worktree and branch, ensuring agent isolation and preventing interference.
• Multi-Agent Support: Integrates with various AI models (Claude Code, OpenAI Codex, Cursor, OpenCode) using existing API keys.
• Interactive Steering: Allows live output monitoring, mid-flight prompt injection, and file referencing via @mention.
• Integrated Review: Features side-by-side diffs, a Monaco editor, and built-in terminals within the UI for comprehensive code review.
• One-Click Shipping: Enables direct creation of PRs, commits, pushes, merges, and CI fixes for GitHub and GitLab, including stacked PR support.
• Local-First Architecture: All code, sessions, and credentials remain on the user's machine, enhancing privacy and security.
• Scriptability: Includes a companion CLI and an MCP server for programmatic control and integration with other tools.

Maintenance & Community

• Community: Discord server for questions and feedback, GitHub Issues for bug reports and feature requests.
• Links: Discord, GitHub Issues.

Licensing & Compatibility

• License type: Apache 2.0.
• Compatibility notes: The permissive Apache 2.0 license is suitable for commercial use and integration with closed-source projects.

Limitations & Caveats

The project appears to be actively developed, with build-from-source instructions provided. Specific limitations regarding platform support beyond macOS/Windows, performance benchmarks, or known stability issues are not detailed in the README.