getting started

installation

download atlas from the download page and drag it to your applications folder. atlas requires macos 13+.

adding a repository

open atlas and click add repository. paste a github url (https or ssh) and atlas will clone the repo to ~/.atlas/repos/. you’ll see real-time progress as it clones.

behind the scenes, atlas detaches HEAD on the clone so that worktrees can freely use any branch — including the default branch.

creating a workspace

select a repo and click new workspace. you’ll see options for:

• branch — create a new branch or check out an existing one
• workspace name — auto-generated (like amber-arch) or enter your own
• base branch — which remote branch to create from (defaults to the repo’s default branch)
• jira ticket — optionally link a jira issue to this workspace

atlas creates a git worktree at ~/.atlas/workspaces/{repo}/{workspace} and, if your repo has a .atlas/setup.sh script, runs it automatically.

new branches are prefixed with ws/ (e.g., ws/amber-arch) to keep workspace branches organized.

what’s next

once your workspace is created, you’ll have access to integrated terminals, a file browser, git tools, and coding agents — all scoped to that worktree.