Orbit / Download for macOS

Orbit for macOS

Orbit runs your task list as parallel work. Each task gets an AI coding agent in its own git worktree, and one queue shows you only what needs a human. The whole local product is free.

The one-line install, with no Gatekeeper prompt

Orbit is signed but not notarized, because notarization needs a paid Apple Developer account. So macOS marks the download as quarantined and asks for one confirmation the first time. The install script does the whole thing in one step, including clearing that flag, so no dialog appears at all:

curl -fsSL https://getorbit.tech/install.sh | bash

It downloads the current release, copies ORBIT.app to Applications, removes the quarantine attribute, and cleans up after itself. Nothing else on your machine is touched. Piping a script into bash deserves a look first, which is why it is short and commented: read it at getorbit.tech/install.sh.

Prefer the .dmg? First launch on macOS 15 and later

Downloading by hand means macOS quarantines the app and blocks the first launch. Older guides tell you to right-click and choose Open. That stopped working in macOS 15 Sequoia. Here is the path that does work now.

1. Open Orbit normally and let it get blockedDouble-click it in Applications. macOS refuses and says it cannot verify the developer. That refusal is the step that registers the app with the system, so it has to happen first.
2. Go to System Settings, then Privacy & SecurityScroll down to the Security section. There is a line naming ORBIT and a button next to it.
3. Click Open Anyway and authenticateTouch ID or your password. Then open Orbit again and confirm once more. macOS remembers after that and every later launch is normal.

Notarization needs a paid Apple Developer account and a signing identity. It is on the list and it is not done yet. Until then you are running an unsigned binary from a solo developer, which is a real thing to weigh rather than a formality to click through.

Would rather not? Leave your email at the bottom of the page. You will get one message when notarized builds ship and nothing else.

Install

1. Open the .dmg and drag Orbit to ApplicationsOn the first launch macOS blocks it; use the Privacy & Security path above to allow it once.
2. Add a projectPick a folder that is already a git repository. Orbit does not modify your working checkout; it creates worktrees under ~/.orbit/worktrees instead.
3. Let it detect your agentsClaude Code, OpenAI Codex, Cursor Agent, Gemini CLI, OpenCode, GitHub Copilot, Amp, Droid, Aider and Pi all have first-class presets and are found automatically if they are on your PATH. Anything else that runs in a terminal can be added by hand.
4. Set your verify commandsGive Orbit the lint, typecheck and test commands for the repo. An agent saying it finished does not mark work ready for review; passing your commands does.

Requirements

Where your data lives

Everything Orbit knows sits in one SQLite file at ~/.orbit/orbit.sqlite, with worktrees under ~/.orbit/worktrees/<project>/<branch>. You can open that database with any SQLite client and read every row. Uninstalling is dragging the app to the trash and deleting ~/.orbit.

The optional cloud syncs orchestration metadata only: project names, workspace status, tasks. Source code, diffs and terminal output never go to it. If you never sign in, nothing leaves the machine at all.

Open a worktree in the editor you already use

Orbit is not trying to replace your editor. Any workspace opens in VS Code, Cursor, Windsurf, Zed, Xcode, a JetBrains IDE, Sublime Text or a terminal with one click. Review diffs and merge in Orbit, or do that part wherever you prefer.

Keep reading

Orbit for Windows · Is Orbit open source?