02 - Install Helmor#

Helmor is a native macOS desktop app. Download, install, and complete first-launch setup in under five minutes.

Download#

Get the latest .dmg from the Helmor releases page on GitHub. Choose the build that matches your Mac architecture (Apple Silicon or Intel).

Install#

Open the downloaded .dmg file.
Drag Helmor into your Applications folder.
Launch Helmor. If macOS shows an "unidentified developer" warning, go to System Settings → Privacy & Security and click Open Anyway.

Prerequisites#

Before your first session, confirm the following:

Git is installed and available in your terminal (git --version).
A supported coding agent CLI is installed and authenticated. Helmor orchestrates agents like Claude Code or Codex — each requires its own provider credentials.
(Optional) GitHub account — sign in if you want remote repository access, branch tracking, and pull request workflows.

First launch#

When Helmor opens for the first time:

Add a repository — pick a local Git project or connect a GitHub repo.
Helmor stores all data (workspaces, sessions, settings) locally on your machine. Nothing is sent to external servers unless you explicitly use a connected agent provider or GitHub.

Verify the install#

Create a workspace, start a short test session (e.g., "list the files in this repo"), and confirm the agent responds. If the session fails, check that your agent CLI is on PATH and authenticated.

Next steps#

Add a Repository — connect your first project.
Debugging Guide — troubleshoot launch or sidecar issues.

Minimum requirements: macOS 12+, Git 2.30+, 4 GB RAM.