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 —
helmorCLI 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
- Add a repository — link a local clone, or clone from a URL.
- Create a workspace — fresh git worktree and branch under
~/helmor/workspaces/. - Prompt an agent — describe the task and move on while it runs.
- Review and ship — read the diff, run tests, create and merge the PR.
Get started
macOS (Apple Silicon & Intel) · Windows (x64)
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