Definition#

A repository is the source project Helmor manages. It gives Helmor the file tree, Git history, branches, and context needed for agent work.

What it enables#

• Create isolated workspaces from a real codebase.
• Browse and edit files inside Helmor.
• Compare agent changes against a target branch.
• Connect work to GitHub when remote shipping is needed.

Local and GitHub context#

A local repository is enough for isolated agent work and review. GitHub connection adds account identity, remote branch context, pull request workflows, and smoother collaboration with the upstream repository.

Best practice#

Add the repository once, then create separate workspaces for separate tasks. Avoid using one long-lived workspace as a dumping ground for unrelated changes.