Orca：基于 Git Worktree 的并行代理开发工作流工具

Title: Orca:基于 Git Worktree 的并行代理开发工作流工具

Core Summary: Orca is a CLI tool designed for agent-based development, using Git Worktree to create isolated workspaces. Key features include parallel task execution, real-time bidirectional sync, interactive code review, and Claude Code integration—addressing pain points like file conflicts and context loss in parallel agent workflows.

With AI programming assistants and agents becoming popular, developers often handle multiple parallel code experiments. Traditional Git branch switching struggles with simultaneous tasks, leading to file conflicts, state chaos, and context loss. Orca was built to solve this by providing isolated workspaces via Git Worktree.

Git Worktree is an underused Git feature allowing multiple branches in separate directories. Orca wraps this into a user-friendly CLI, managing workspaces in ~/.orca/workspaces/. Each workspace is an independent Git Worktree (own dir/branch) but shares repo history—balancing isolation and disk efficiency.

Basic Workflow: Run orca new (with --branch for custom branches) to create a workspace. orca status shows workspace states (diffs, upstream status, PR info with GitHub CLI). orca rm deletes workspaces.

Sync Feature: orca sync enables bidirectional real-time sync between main repo and workspaces—respects .gitignore, uses debounce, and restores main repo state on exit.

Code Review: orca critique opens a browser interface for diff reviews, allowing line-by-line comments passed to agents as feedback.

Claude Integration: Install via /plugin marketplace add SamYouatt/orca to use Orca directly in Claude Code—no terminal-editor switching.

Orca supports global (~/.orca/settings.json) and project-level (orca.json) configs. Define setup/teardown scripts for workspace creation/deletion (global scripts run before/after project scripts). Scripts access env vars (workspace name, branch, path) for custom logic—refer to COOKBOOK.md for examples.

Orca is not just a Git wrapper—it’s a complete solution for parallel agent workflows. It lets developers leverage multiple AI agents while maintaining code quality control. For Claude Code or AI assistant users, Orca is an essential toolchain addition.