Open Orchestrator

Appearance

Requirements ​

  • Python 3.10 or higher
  • Git
  • tmux
  • An AI coding tool (Claude Code, Pi, OpenCode, or Droid)

Verify Prerequisites ​

bash
# Check Python version
python3 --version  # Should be 3.10+

# Check Git
git --version

# Check tmux
tmux -V

# Check your AI coding tool is on PATH
which claude    # Claude Code
which pi        # Pi
which opencode  # OpenCode
which droid     # Droid

If you want to use Pi and it is not installed yet:

bash
npm install -g @earendil-works/pi-coding-agent

uv is a fast Python package manager that makes installation simple.

bash
# Clone the repository
git clone https://github.com/gitpcl/openorchestrator.git
cd open-orchestrator

# Install with uv
uv pip install -e .

# Or install with dev dependencies
uv pip install -e ".[dev]"

Install with pip ​

bash
# Clone the repository
git clone https://github.com/gitpcl/openorchestrator.git
cd open-orchestrator

# Install with pip
pip install -e .

Verify Installation ​

After installation, verify that owt is available:

bash
owt --help

You should see the help output with available commands:

Usage: owt [OPTIONS] COMMAND [ARGS]...

  Open Orchestrator - Git Worktree + AI Tool Management

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  cleanup       Remove stale worktrees
  create        Create a new worktree
  dashboard     Launch live TUI dashboard
  delete        Delete a worktree
  list          List all worktrees
  ...

Optional: Install Shell Completion ​

Enable tab completion for your shell:

bash
# Show installation instructions
owt completion install

# For bash (add to ~/.bashrc)
eval "$(owt completion bash)"

# For zsh (add to ~/.zshrc)
eval "$(owt completion zsh)"

# For fish (save to completions)
owt completion fish > ~/.config/fish/completions/owt.fish

Optional: Install Claude Code Skill ​

If you use Claude Code, install the Open Orchestrator skill for intelligent command suggestions:

bash
# Install skill (creates symlink - recommended)
owt skill install

# Or install as a copy
owt skill install --copy

# Check installation status
owt skill status

Next Steps ​