01 - Introduction#
Helmor is an open-source local workbench for multi-agent software development. It gives you a single interface to run coding agents inside real repositories, keep each task isolated in its own workspace, and review every change before it ships.
Why Helmor#
Modern coding agents are powerful but messy to supervise. Helmor solves three problems:
- Context isolation — each task runs in a dedicated workspace with its own branch and file state, so agents never pollute unrelated work.
- Visibility — watch agent sessions, tool calls, file edits, and diffs in real time from one dashboard.
- Ship-ready workflow — review, test, commit, and open pull requests without leaving the app.
Core objects#
| Object | Purpose |
|---|---|
| Repository | The source project Helmor manages — local or GitHub-connected. |
| Workspace | An isolated working copy tied to a branch and a single task. |
| Session | The conversation and agent activity inside a workspace. |
| Agent | The CLI-backed coding assistant (e.g., Claude Code, Codex). |
How it works#
- Add a repository.
- Create a workspace targeting a branch.
- Describe a task — Helmor starts a session with your chosen agent.
- Review the diff, run checks, and commit or iterate.
Getting started#
A good first task has one goal, one expected result, and one obvious way to verify it. Start small — once the loop feels natural, scale up to larger refactors and multi-file features.
Next: Install Helmor to set up the app on your Mac.