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#

How it works#

1. Add a repository.
2. Create a workspace targeting a branch.
3. Describe a task — Helmor starts a session with your chosen agent.
4. 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.