Skip to content

Commit 012ccdd

Browse files
ourinesclaude
andcommitted
chore: release v1.3.0
- Update README with new features and badges - Add auto-recovery monitor documentation - Add /worktree-task:help command to docs - Add --codex shorthand documentation - Bump version to 1.3.0 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>
1 parent d0c8477 commit 012ccdd

File tree

2 files changed

+40
-24
lines changed

2 files changed

+40
-24
lines changed

.claude-plugin/plugin.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "worktree-task",
3-
"version": "1.2.0",
3+
"version": "1.3.0",
44
"description": "Manage large coding tasks using git worktrees and background Claude Code sessions. Supports launching, monitoring, resuming, and cleanup of autonomous tasks with alert notifications.",
55
"author": {
66
"name": "ourines"

README.md

Lines changed: 39 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,58 @@
11
# Worktree Task Plugin
22

3-
Manage large coding tasks using git worktrees and background agent sessions(默认启动 Claude Code `claude --dangerously-skip-permissions`,可用 `--codex` 快速切换 Codex CLI,或 `--agent-cmd` 指定任意命令,如 `codex --yolo -m gpt-5.1-codex-max -c model_reasoning_effort="high"`)。
3+
[![GitHub release](https://img.shields.io/github/v/release/ourines/worktree-task-plugin)](https://github.com/ourines/worktree-task-plugin/releases)
4+
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5+
6+
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.
47

58
## Features
69

7-
- **Launch**: Spawn autonomous agent instances (默认 Claude Code,可选 `--codex`/`--agent-cmd`) in separate git worktrees
10+
- **Launch**: Spawn autonomous agent instances in separate git worktrees
11+
- Default: Claude Code (`claude --dangerously-skip-permissions`)
12+
- `--codex`: Quick switch to Codex CLI
13+
- `--agent-cmd`: Custom agent command
14+
- **Auto-Recovery**: Background monitor automatically detects and recovers from errors (rate limits, API errors, timeouts)
815
- **Status**: Monitor running tasks and their progress
9-
- **Resume**: Recover interrupted tasks (rate limits, API errors, timeouts)
16+
- **Resume**: Manually recover interrupted tasks
1017
- **Cleanup**: Remove completed tasks and worktrees
11-
- **Merge**: Merge completed feature branches with automatic conflict resolution
12-
- **Rebase**: Rebase branches with automatic conflict resolution
13-
- **Alert**: macOS notifications when tasks complete or fail
14-
- **Auto-Update Check**: Notifies you when plugin updates are available via `/plugin` commands
18+
- **Merge/Rebase**: Automatic conflict resolution powered by Claude
19+
- **Alerts**: macOS notifications when tasks complete or fail
20+
- **Auto-Update**: Notifies when plugin updates are available
1521

1622
## Usage
1723

1824
### Via Commands (recommended)
1925

2026
```bash
21-
# Launch a new task
27+
# Launch a new task (auto-recovery enabled by default)
2228
/worktree-task:launch "Implement user authentication with OAuth2"
2329

24-
# Check status
30+
# Launch with Codex instead of Claude
31+
/worktree-task:launch --codex "Refactor database layer"
32+
33+
# Launch without auto-recovery
34+
/worktree-task:launch --no-monitor "Quick fix task"
35+
36+
# Check status of all tasks
2537
/worktree-task:status
2638

27-
# Resume interrupted task
39+
# Check specific task
40+
/worktree-task:status my-task
41+
42+
# Resume interrupted task manually
2843
/worktree-task:resume my-task
2944

3045
# Cleanup completed task
3146
/worktree-task:cleanup my-task --keep-worktree
3247

33-
# Merge completed feature branch (run from target branch like dev/main)
48+
# Merge feature branch (run from target branch)
3449
/worktree-task:merge feature-branch
3550

3651
# Rebase current branch onto feature branch
3752
/worktree-task:rebase feature-branch
53+
54+
# Show help
55+
/worktree-task:help
3856
```
3957

4058
### Via Skill (automatic)
@@ -60,7 +78,8 @@ worktree-task/
6078
│ ├── resume.md # /worktree-task:resume
6179
│ ├── cleanup.md # /worktree-task:cleanup
6280
│ ├── merge.md # /worktree-task:merge
63-
│ └── rebase.md # /worktree-task:rebase
81+
│ ├── rebase.md # /worktree-task:rebase
82+
│ └── help.md # /worktree-task:help
6483
├── hooks/
6584
│ ├── hooks.json # Hook registrations
6685
│ └── handlers/
@@ -73,24 +92,21 @@ worktree-task/
7392
│ ├── resume.py # Task resumer
7493
│ ├── cleanup.py # Cleanup handler
7594
│ ├── merge.py # Merge with conflict resolution
76-
│ └── rebase.py # Rebase with conflict resolution
95+
│ ├── rebase.py # Rebase with conflict resolution
96+
│ └── monitor.py # Auto-recovery background monitor
7797
└── references/
7898
├── task-prompt-template.md
7999
└── merge-rebase-prompt-template.md
80100
```
81101

82102
## How It Works
83103

84-
1. **Launch**: Creates a git worktree, starts a tmux session, runs Claude Code(或通过 `--codex`/`--agent-cmd` 指定的命令)with the task prompt
85-
2. **Monitor**: Polls tmux panes to detect completion, errors, or rate limits
86-
3. **Alert**: Sends macOS notifications via `osascript`
87-
4. **Resume**: Detects interrupted state and restarts with context
88-
5. **Cleanup**: Kills tmux session, removes worktree (optionally keeps branch)
89-
6. **Merge/Rebase**:
90-
- Checks if feature branch has a worktree
91-
- If yes: enters worktree, rebases feature onto target branch
92-
- Returns to main repo, performs merge/rebase
93-
- Uses Claude Code in tmux to automatically resolve conflicts
104+
1. **Launch**: Creates a git worktree, starts a tmux session, runs the agent with task prompt
105+
2. **Auto-Recovery**: Background monitor polls for errors and automatically resumes (rate limits, API errors, timeouts)
106+
3. **Monitor**: Check progress via `/worktree-task:status`
107+
4. **Alert**: macOS notifications via `osascript` on completion/failure
108+
5. **Cleanup**: Kills tmux session, stops monitor, removes worktree
109+
6. **Merge/Rebase**: Uses Claude in tmux to automatically resolve conflicts
94110

95111
## Configuration
96112

0 commit comments

Comments
 (0)