Orbit
Local-first runtime that queues coding-agent tasks and delivers them via sandboxed worktrees.
Tested on macOS and Linux
Use it
macOS arm64
You need first
- Runtimes:
Node 18+
Install Orbit CLI globally via npm
npm install -g @orbit-tools/cli
Check that it works
orbit --versionThe output should contain “orbit 0.38.0”.
First thing to try
orbit init --non-interactive --machine-name box --task-prefix BOXIn a git repository, run orbit workspace init --ship-mode local to set up Orbit for that project.
Linux x86_64
You need first
- Runtimes:
Node 18+
install @orbit-tools/cli globally via npm
npm install -g @orbit-tools/cli && orbit --version
Where the README and reality differ
- README: README examples imply filing tasks via agent prompt
What worked: orbit task add requires --title and --complexity; --prompt is not a flag, use --description
Check that it works
orbit --versionThe output should contain “orbit 0.39.0”.
First thing to try
mkdir -p /tmp/orbit-demo && cd /tmp/orbit-demo && git init -q && git config user.email "test@test.com" && git config user.name "test" && touch README.md && git add . && git commit -qm init && orbit workspace init --ship-mode local && echo WORKSPACE_INIT_OK && ls -la .orbit/cd /tmp/orbit-demo && orbit task add --title "Add hello.txt" --description "Add hello.txt containing hello" --complexity low --status backlog 2>&1In a git repository, run orbit workspace init --ship-mode local to set up Orbit for that project.
What it does
- Queue coding tasks that persistTested
How to use it
- Inside a git repository, run
orbit workspace init --ship-mode localonce. - Add a task with
orbit task add --title "<title>" --description "<description>" --complexity low --status backlog. - Note the task ID it prints, such as ORB-00000.
- Inside a git repository, run
- Run agents in isolated worktreesNot tested
- Deliver changes through a gated pipelineNot tested
- Audit the prompt, plan and reviewNot shown working
How far pickfit got
macOS arm64
- Installs
- Starts
- Answers requests
- Works offline
Linux x86_64
- Installs
- Starts
- 1 of 4 features work
- Works offline
Other systems
Good for
- run queued tasks through plan, execute and review in isolated worktrees
- open a pull request for task output and close task after merge
- inspect a task or run
- open the dashboard to watch tasks
- pick the default provider and model crew
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
macOS arm64
Its service answers requests
- Replayed from scratch
- Works offline
- Checked on 29 Oct 2026
- Version 0.38.0
Differences the test machine hit
- README: orbit init
In the test: run non-interactively as `orbit init --non-interactive --machine-name box --task-prefix BOX` (any 2-5 uppercase-letter prefix); stdin is closed so the interactive prompts cannot be answered
Linux x86_64
Its service answers requests
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 0.39.0
Differences the test machine hit
- README: orbit doctor
In the test: orbit doctor exits 1 when checks fail (1 failure for missing machine identity); exit 1 signals findings not a crash - README: locks gate dispatch
In the test: orbit task locks needs a subcommand (locks list); bare locks prints usage with exit 2