TheAhmadOsman

TheAhmadOsman / parallel-agent-worktree-skill

Public

Portable Agent Skill to plan, spawn, review, and merge parallel CLI agents in isolated git worktrees, with deterministic Python/Bash runners for condition-gated, backup-safe, log-heavy workflows. Includes a Kimi CLI example; easily adapted to Codex CLI, Claude Code, OpenCode, Droid Factory, Pi, or any CLI harness.

14
1
69% credibility
Found Apr 13, 2026 at 17 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

A portable skill for coordinating multiple AI agents to perform parallel tasks in isolated development environments with review gates, backups, and changelog requirements.

How It Works

1
🔍 Discover the skill

You hear about a helpful tool that lets your main AI assistant split big coding jobs into smaller tasks for multiple helper AIs to tackle together safely.

2
📥 Add the skill

You simply copy the skill folder into your project's AI tools directory to make it ready for use.

3
💬 Give instructions

You tell your main AI assistant to use the skill for your task, describing what needs to be done.

4
Choose work style
👀
Live guiding

Helpers work in separate windows where you can watch and send follow-up tips as needed.

⏰
Automatic mode

Helpers run on their own with built-in backups and tests before combining results.

5
🚀 Helpers in action

Your main AI fans out tasks to helpers working side-by-side in safe, isolated spaces, feeling powerful and organized.

6
🔍 Review results

Check the changes each helper made, update notes, and approve the good work.

🎉 Task complete

Everything merges back perfectly, your big project advances quickly and safely, ready for the next step.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 17 to 14 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is parallel-agent-worktree-skill?

This portable AI agent skill orchestrates parallel CLI agents—like Kimi, Codex CLI, or Claude—in isolated git worktrees, handling planning, spawning, review, and merging with changelog mandates. Built in Python, it offers interactive tmux sessions for steering or deterministic Bash/Python runners gated by backups, conditions, and logs, solving the mess of concurrent agents clobbering shared repos. Copy it as a github portable app into your agent skills dir for instant use.

Why is it gaining traction?

Its harness-portability shines: easily adapted to any CLI agent via help-output mapping, unlike siloed tools assuming one model. Users love worktree isolation for safe parallelism, diff reviews before merges, and portable github git workflows that log everything without global deps—think uv-run scripts for self-tests. With tmux for hands-on control and JSON plans for automation, it hooks devs scaling agent tasks repeatably.

Who should use this?

DevOps running self-hosted upgrades or fleet maintenance via agents, AI coders splitting epics into parallel worktrees with changelog enforcement, or teams needing portable agent ransack for git repos. Ideal for those tired of serial agent runs blocking on conflicts, especially with CLI harnesses like portable github cli or voice agent portable setups.

Verdict

Alpha-stage with 14 stars and 0.70% credibility score; docs and tests are thorough, but heed the "experimental dangerous" warnings—review all outputs. Grab the github portable download for git-agent workflows if you're authorized and backed up.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.