Skip to content

Releases: gitpcl/openorchestrator

v0.1.0 - Initial Release (Pre-release)

06 Feb 03:38
@gitpcl gitpcl
v0.1.0
28cdb22

Choose a tag to compare

View all tags
v0.1.0 - Initial Release (Pre-release) Pre-release
Pre-release

Open Orchestrator v0.1.0

v0.1.0 Pre-release - First public version with core functionality complete. All features implemented and
tested. Recommended for early adopters who want to help shape the tool before v1.0.0 stable release.

🎉 Key Features

🆕 Unified Workspace Mode (Default)

  • Single tmux session: All worktrees visible as panes (like Claude Code Agent Teams)
  • main-focus layout: 1/3 left (main) + 3 horizontal worktree panes (right)
  • Max 4 panes: 1 main + 3 worktrees per workspace
  • Opt-out available: `--separate-session` flag for standalone sessions
  • Commands: `workspace list/show/attach/destroy`

Core Orchestration

  • Git worktree management: Create, list, switch, delete with auto branch handling
  • Multi-AI tool support: Claude Code, OpenCode, Droid
  • tmux integration: 6 customizable layouts (main-focus, main-vertical, three-pane, quad, etc.)
  • Project detection: Auto-detect Python, Node.js, Rust, Go, PHP projects
  • Environment setup: Auto-install dependencies, copy .env files with path adjustments

Workflow Templates (8 included)

Pre-configured templates for common patterns:

  • `bugfix` - Quick fixes with minimal changes
  • `feature` - Full TDD feature development
  • `refactor` - Code quality improvements
  • `docs` - Documentation updates
  • `security-audit` - Security scanning
  • `research` - Read-only exploration
  • `experiment` - Isolated prototyping
  • `hotfix` - Emergency production fixes

Monitoring & Health

  • Health checks: Detect stuck tasks, high costs, stale worktrees
  • Cost optimization: Track token usage, compare AI tool pricing
  • Live TUI dashboard: Real-time monitoring with `owt dashboard`
  • Token tracking: Per-worktree usage and cost estimates
  • Status tracking: Monitor AI activity across all worktrees

Maintenance & Integration

  • Smart cleanup: Auto-detect and remove stale worktrees (dry-run safe)
  • Sync service: Keep worktrees updated with upstream branches
  • GitHub PR integration: Link worktrees to PRs, track status, cleanup merged
  • Status hooks: Trigger notifications/webhooks on status changes
  • Session management: Copy/resume Claude sessions between worktrees

Developer Experience

  • Shell completion: bash, zsh, fish auto-completion
  • No-tmux mode: Manage AI processes without tmux (`owt process`)
  • Self-update: Built-in update checker (`owt update --check`)
  • CLI skill: Claude Code skill for /worktree commands

📦 Installation

```bash
git clone https://github.com/gitpcl/openorchestrator.git
cd open-orchestrator
uv pip install -e .
```

Requirements: Python 3.10+, Git, tmux, Claude Code CLI

🚀 Quick Start

```bash

Create worktrees in unified workspace (default)

owt create feature/api # Creates workspace + adds pane
owt create bugfix/auth # Adds to same workspace

View workspace

owt workspace attach owt-myproject

Monitor activity

owt dashboard # Live TUI dashboard
owt status # AI activity status
owt health --all # Health check all worktrees

Templates

owt create hotfix/critical --template hotfix
owt template list # See all 8 templates
```

📊 Project Stats

  • 16 core modules: worktree, workspace, tmux, templates, health, status, cost, etc.
  • 100+ CLI commands across 14 command groups
  • 8 workflow templates with AI tool optimization
  • 3 AI tools: Claude Code, OpenCode, Droid
  • 6 tmux layouts: main-focus, main-vertical, three-pane, quad, etc.
  • Test coverage: 90%+ on critical paths

🔧 Supported AI Tools

  • Claude Code (default) - Best for complex reasoning
  • OpenCode - Cost-effective alternative
  • Droid - Factory.ai's autonomous agent

📚 Documentation

🙏 Credits

Built with Python, Click, Pydantic, Rich, libtmux.

Report issues: https://github.com/gitpcl/openorchestrator/issues

Loading