ourines/worktree-task-plugin

38 stars · Last commit 2025-12-20

Claude Code plugin for managing large coding tasks using git worktrees and background sessions

README preview

# Worktree Task Plugin

[![GitHub release](https://img.shields.io/github/v/release/ourines/worktree-task-plugin)](https://github.com/ourines/worktree-task-plugin/releases)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Manage large coding tasks using git worktrees and background agent sessions. Spawns autonomous Claude Code or Codex instances that run independently, freeing your main session.

## Features

- **Launch**: Spawn autonomous agent instances in separate git worktrees
  - Default: Claude Code (`claude --dangerously-skip-permissions`)
  - `--codex`: Quick switch to Codex CLI
  - `--agent-cmd`: Custom agent command
- **Auto-Recovery**: Background monitor automatically detects and recovers from errors (rate limits, API errors, timeouts)
- **Status**: Monitor running tasks and their progress
- **Resume**: Manually recover interrupted tasks
- **Cleanup**: Remove completed tasks and worktrees
- **Merge/Rebase**: Automatic conflict resolution powered by Claude
- **Alerts**: macOS notifications when tasks complete or fail
- **Auto-Update**: Notifies when plugin updates are available

View full repository on GitHub →