agh-worktree-isolation
OfficialRun parallel agent worktrees without deadlocks.
Software Engineering#agent runtime#local-first#worktree isolation#SQLite lock#port deconfliction#tmux bridge#parallel QA
Authorcompozy
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Prevents concurrent agent worktrees from deadlocking or corrupting shared local state by isolating AGH_HOME, daemon ports, and tmux-bridge socket paths.
Core Features & Use Cases
- Isolated AGH runtime envelope: Allocates a unique AGH_HOME directory per scenario to avoid SQLite contention and cross-run interference.
- Port and socket deconfliction: Picks free localhost TCP ports for the daemon and a unique UDS path, plus a dedicated tmux-bridge socket.
- Concurrency-safety guardrails: Designed to be the low-level primitive beneath QA execution skills, blocking operations that would write to the default home or default ports when parallelism is signaled.
Quick Start
Ask an agent to create an isolated envelope for a parallel QA scenario by running: python3 .agents/skills/agh-worktree-isolation/scripts/allocate-isolation.py --slug "your-scenario-slug" and then source the printed export statements to run your QA inside the isolated environment.
Dependency Matrix
Required Modules
None requiredComponents
scripts
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: agh-worktree-isolation Download link: https://github.com/compozy/agh/archive/main.zip#agh-worktree-isolation Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.