03 - Add a Repository#

A repository is the project Helmor will manage. Once added, you can create workspaces, browse files, run agent sessions, and review diffs — all against that project's codebase.

Add a local repository#

1. Open Helmor and click Add Repository (or use the + button in the sidebar).
2. Browse to your local Git project folder.
3. Confirm the detected default branch (e.g., main or master).

The repository appears in your sidebar immediately. Helmor reads the Git history, branches, and file tree from disk.

Add a GitHub repository#

1. Sign in to GitHub when prompted (one-time setup under Settings → GitHub).
2. Choose Import from GitHub and select the repository from your account or organization.
3. Helmor clones it locally and links the remote context for branch tracking and pull request workflows.

What Helmor reads#

Helmor uses the repository as the source for:

• Workspaces — isolated copies branched from your default or target branch.
• File browsing — view, search, and navigate the project tree.
• Diffs — compare agent changes against the base branch.
• Git operations — commit, push, and prepare PRs from inside the app.

Helmor does not replace Git. It wraps Git with an agent-friendly workflow layer.

Best practices#

• Add repositories you are comfortable reviewing through Helmor.
• Use one workspace per task — avoid long-lived "catch-all" workspaces with unrelated changes.
• For team projects, connect GitHub so workspaces can target the correct remote branch and shipping path.

Next: Create a Workspace to start your first task.