Skip to content

dohooo/helmor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,752 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Helmor logo

Helmor

The local-first workbench for orchestrating coding agents.

Latest release Discord User docs License: Apache 2.0

Helmor screenshot

AI made coding faster. Helmor is about finishing the rest of the loop — orchestrating, reviewing, testing, merging, and actually shipping software.

Helmor runs many coding agents in parallel, each inside its own isolated git workspace, and gives you one place to steer them all: conversation, diffs, a real editor, terminals, run scripts, and one-click PR actions. Everything is stored in a local SQLite database on your machine.

Highlights

  • Isolated workspaces — every task gets its own git worktree and branch. Agents never trample each other's changes, and your main stays clean.
  • Bring your own agents — Claude Code, OpenAI Codex, Cursor, and OpenCode side by side, using your existing logins and API keys. Pick the model, effort level, plan mode, or fast mode per message.
  • Steer mid-flight — watch output stream live, inject follow-ups while the agent is still working, queue prompts, paste images, mention files with @.
  • Review without leaving — changed files, side-by-side diffs, a Monaco editor, and built-in terminals sit right next to the conversation.
  • Ship from one button — Create PR, Commit & Push, Pull Latest, Merge, Fix CI, Resolve Conflicts. Stacked PRs included. GitHub and GitLab.
  • Local-first — your code, sessions, and credentials never leave your machine, except for the agent API calls you choose to make.
  • Scriptable — a full helmor CLI and a built-in MCP server, so your terminal — or another agent — can drive Helmor too.

Install

Download Helmor

  • macOS — Apple Silicon and Intel (DMG)
  • Windows — x64 setup installer

On first launch, Helmor walks you through connecting GitHub or GitLab and signing in to your first agent. Agent CLIs are bundled — there is nothing else to install. See the install guide for details.

How it works

  1. Add a repository — link a local clone, or clone from a URL.
  2. Create a workspace — Helmor makes a fresh git worktree and branch under ~/helmor/workspaces/ and runs your project's setup script.
  3. Prompt an agent — choose a model, describe the task, and move on to the next workspace while it runs.
  4. Review and ship — read the diff, run your tests, then create and merge the PR from the inspector.

Repeat in parallel. Each workspace is fully independent, so five agents can work on five tasks in the same repository at once.

Documentation

The full user guide lives in docs/user/:

CLI

Helmor ships a companion CLI that works against the same local database as the app — even while the app is running:

helmor workspace new --repo myapp
helmor send --workspace myapp/feature-x "Add a test for the parser edge case."
helmor workspace status myapp/feature-x

helmor mcp exposes the same surface as an MCP server over stdio, so other agents and tools can operate Helmor. See CLI & MCP.

Building from source

Prerequisites: Bun 1.3+, a stable Rust toolchain, and platform build tools (Xcode Command Line Tools on macOS). A Nix flake is also available — see NIX_SETUP.md.

bun install        # installs frontend + sidecar dependencies
bun run dev        # full desktop app in development mode
bun run test       # frontend, sidecar, and Rust test suites

Architecture notes for contributors (and their agents) live in AGENTS.md.

Community

  • Discord — questions, feedback, release chat
  • GitHub Issues — bugs and feature requests
  • Or use the feedback button at the bottom of Helmor's sidebar

License

Apache 2.0