Helmor

The local-first workbench for orchestrating coding agents.

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 in its own isolated git workspace — conversation, diffs, editor, terminals, and one-click PR actions in one window. Everything lives locally under ~/helmor/.

Features

• Isolated workspaces — one git worktree and branch per task; agents never step on each other.
• Bring your own agents — Claude Code, Codex, Cursor, OpenCode, and Kimi Code; your logins, API keys, and custom providers.
• Review without leaving — diffs, Monaco editor, and terminals beside the conversation.
• Ship from one button — create PR/MR, merge, fix CI, resolve conflicts, stacked PRs; GitHub and GitLab.
• Terminal Mode — run prompts in the agent's native TUI, or resume a GUI chat in the terminal.
• Quick panel — ⇧⌥Space opens a floating window to start a workspace and chat from anywhere.
• Scriptable — helmor CLI and MCP server; your terminal or another agent can drive Helmor.
• Skills — install from onboarding or Settings → Helmor Components; browse with / in the composer.
• Mobile companion (experimental) — Cloudflare tunnel to your desktop; start tasks from your phone's browser.

More on the way — Slack & GitHub context, plan mode, and agent-driven orchestration.

How it works

flowchart LR
  A[Add a repository] --> B[Create a workspace]
  B --> C[Prompt an agent]
  C --> D[Review and ship]
  D -.->|repeat in parallel| B

1. Add a repository — link a local clone, or clone from a URL.
2. Create a workspace — fresh git worktree and branch under ~/helmor/workspaces/.
3. Prompt an agent — describe the task and move on while it runs.
4. Review and ship — read the diff, run tests, create and merge the PR.

Get started

Download Helmor →

macOS (Apple Silicon & Intel) · Windows (x64)

Read the docs →

On first launch, connect GitHub or GitLab and sign in to your first agent. Agent CLIs are bundled — nothing else to install.

CLI

Install from Settings → Experimental → Command Line Tool. Works against the same local database as the app — even while it is running.

helmor repo add /path/to/repo
helmor workspace new --repo myapp
helmor workspace list
helmor send --workspace myapp/feature-x "Add a test for the parser edge case."
helmor workspace status myapp/feature-x
helmor workspace run-action myapp/feature-x   # create PR, merge, fix CI, …
helmor mcp                                    # MCP server over stdio

Workspaces use repo-name/directory-name shorthand. Every command supports --json. Run helmor --help for the full reference.

Example — an agent ships a fix:

helmor workspace new --repo myapp --name fix-auth
helmor send --workspace myapp/fix-auth "Add tests for the token refresh path."
helmor workspace status myapp/fix-auth
helmor workspace run-action myapp/fix-auth

Contributing

Architecture, commands, and test layout live in AGENTS.md. To get started locally: bun install && bun run dev.

Or —

Open Helmor, Import Helmor, Ask Helmor:

"How do I contribute to Helmor?"

That's the guide.

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