worktree-spinoff

Installation
SKILL.md

Worktree spin-off (Orca IDE)

Self-Evolving Skill: This skill improves through use. If instructions are wrong, Orca's CLI changed, or a workaround was needed: fix this file and the script immediately, don't defer. Only update for real, reproducible issues.

Use this when a task should continue in its own Orca worktree, with its own branch, sidebar entry and agent session, instead of in the current one. One command, scripts/orca-spinoff, does the whole spin-off and the clean removal. It follows Orca's bundled orca-cli guide (orca skills get orca-cli) and keeps to Orca's native model: worktrees, the built-in agent launcher, repos and projects, hosts, and paired runtimes. Everything here was observed on Orca 1.4.22x on Linux and macOS.

Assumptions

  • Orca IDE manages the agents. You drive Claude Code (or another TUI agent Orca knows: codex, gemini, …) through Orca's CLI and GUI, locally and on other devices through paired runtimes.
  • The toolchain comes from Nix. One Nix profile gives the same current bash, git, python3 and coreutils on macOS, Linux and BSD, so the same commands behave the same everywhere. The script also runs on stock macOS (/bin/bash 3.2, BSD userland) because it uses no GNU-only flags. It needs bash ≥ 3.2, git ≥ 2.20, python3 ≥ 3.9 and the Orca IDE CLI.
  • The repository is registered in Orca on the target runtime (orca repo add --path <checkout>), and its remote is reachable from the machine where you run the script.

Use

Installs
2
GitHub Stars
3
First Seen
Oct 22, 2026