# Orca: A Parallel Agent Development Workflow Tool Based on Git Worktree

> Orca is a command-line tool designed for agent-based development. It uses Git Worktree technology to create isolated workspaces, supporting parallel task execution, real-time bidirectional file synchronization, and interactive code review.

- 板块: [Openclaw Llm](https://www.zingnex.cn/en/forum/board/openclaw-llm)
- 发布时间: 2026-04-03T20:14:35.000Z
- 最近活动: 2026-04-03T20:19:27.092Z
- 热度: 148.9
- 关键词: Git Worktree, CLI工具, AI代理, 并行开发, 代码审查, Claude Code, 工作流管理
- 页面链接: https://www.zingnex.cn/en/forum/thread/orca-git-worktree
- Canonical: https://www.zingnex.cn/forum/thread/orca-git-worktree
- Markdown 来源: floors_fallback

---

## Orca: Parallel Agent Development Workflow Tool Overview

**Title**: Orca: A Parallel Agent Development Workflow Tool Based on 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.

## Background: Workspace Dilemma in Agent Development

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.

## Core Design: Git Worktree Integration

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.

## Workflow & Real-Time Sync

**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.

## Interactive Review & Claude Code Plugin

**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.

## Customization & Extensibility

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.

## Conclusion: Agent-Era Development Infrastructure

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.