skills.rest
ourines
ourinesCOMMUNITY
Explore all skills by this author →
GitHub

worktree-task

Launch background agent sessions for large coding tasks via git worktrees and tmux.

39|4|Updated Nov 27, 2025
Search Tags:#developer tools#software development#claude code#background tasks#conflict resolution#git worktrees#code automation
One-click install
npx skills add https://github.com/ourines/worktree-task-plugin --skill worktree-task
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: worktree-task
Source: https://github.com/ourines/worktree-task-plugin/tree/main/skills/worktree-task
Command: npx skills add https://github.com/ourines/worktree-task-plugin --skill worktree-task

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Large, complex coding tasks often monopolize your AI session, demanding constant attention and preventing you from moving on to other work. This Skill frees you from that bottleneck by allowing Claude to tackle extensive projects autonomously in the background.

Core Features & Use Cases

  • Background Task Execution: Launch complex coding projects (e.g., implementing a new service, major refactoring) in isolated git worktrees, running autonomously via Claude Code.
  • Automated Conflict Resolution: Seamlessly merge or rebase feature branches, with Claude Code automatically resolving conflicts.
  • Resilience & Monitoring: Automatically resume interrupted tasks and receive macOS notifications on completion or failure.
  • Use Case: Imagine you need to implement a new user authentication system. Instead of tying up your current AI session, you can instruct Claude to "Launch a background task to implement OAuth2 authentication in a new worktree." You'll be notified when it's done, and Claude can even help merge the changes.

Quick Start

Launch a new background task to implement user authentication with OAuth2.

Frequently Asked Questions about worktree-task

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run large coding tasks without blocking my current Claude Code session?▼

Background task execution launches autonomous agent sessions in isolated git worktrees, allowing complex projects like service implementation or major refactors to run in parallel via tmux, keeping your main session free for other work.

Can Claude Code automatically resolve merge conflicts when working with git worktrees?▼

Yes, automated conflict resolution seamlessly merges or rebases feature branches with Claude Code handling conflicts autonomously, eliminating manual intervention during background task execution.

What happens if a background coding task gets interrupted?▼

Resilience monitoring automatically resumes interrupted tasks and sends macOS notifications on completion or failure, ensuring long-running projects recover without manual restart or session recreation.

How do I track progress on a multi-phase coding project running in the background?▼

Progress tracking uses TodoWrite to log completion status across logical units, while atomic commits after each phase ensure transparent, resumable execution and clear project advancement visibility.

Can I switch between Claude Code and other agents for background task execution?▼

Task execution supports switching between Claude Code and Codex via --codex or --agent-cmd flags, enabling flexible agent selection based on task requirements and performance needs.

Do I need git worktrees to run background coding tasks?▼

Yes, background tasks require git worktrees created under the parent directory to isolate work and enable parallel execution without affecting your main branch or current session state.

Related Skills

Explore More Software Engineering Skills→
Zenobia000Zenobia000
2

dmux-workflows

Orchestrate parallel AI agent sessions across development harnesses using tmux pane management.

Community
Intermediate
doravidandoravidan

ralph-merge

Merge RALPH worktree changes into the main branch with optional squash.

Community
Basic
rhpdsrhpds

23-background-agents-goal-mode

Manage Claude Code background sessions with goal-based autonomous execution.

Official
Advanced
MelvynxMelvynx
223

merge

Automate Git branch merges with context-aware conflict resolution.

Community
Advanced