Helmor
Open-source local workbench for multi-agent software development.
**helmor** is a Open-source local workbench for multi-agent software development. The project is written primarily in TypeScript, distributed under the Apache License 2.0 license, first published in 2026. It has gained significant community traction with 1,231 stars and 108 forks on GitHub. Key topics include: agent-orchestration, ai, claude-code, codex, 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 — Smart Triage, Slack & GitHub context, plan mode, and agent-driven orchestration.
How it works
mermaidflowchart 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.
bashhelmor 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:
bashhelmor 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
Contributors
Showing top 12 contributors by commit count.
