Claude-skill-registry ac-workspace-manager

Manage git worktrees for isolated development. Use when creating isolated workspaces, managing parallel development, handling worktree lifecycle, or merging completed work.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/ac-workspace-manager" ~/.claude/skills/majiayu000-claude-skill-registry-ac-workspace-manager && rm -rf "$T"

manifest: skills/data/ac-workspace-manager/SKILL.md

AC Workspace Manager

Manage git worktrees for isolated autonomous development.

Purpose

Provides workspace isolation using git worktrees, enabling parallel development and safe rollback without affecting the main branch.

Quick Start

from scripts.workspace_manager import WorkspaceManager

manager = WorkspaceManager(project_dir)
worktree = await manager.create_worktree("feature-auth")
await manager.merge_completed(worktree)

Worktree Strategy

main branch (stable)
│
├── .worktrees/
│   ├── build-001/  ← Isolated worktree
│   ├── build-002/  ← Another build
│   └── build-003/  ← Parallel work
│
└── project files

Workflow

Create: New worktree from main branch
Develop: All changes in isolated workspace
Review: Review changes before merge
Merge: Merge back to main
Cleanup: Remove worktree

API

# Create new worktree
worktree = await manager.create_worktree("build-001")

# Get current worktree
current = await manager.get_current_worktree()

# List all worktrees
worktrees = await manager.list_worktrees()

# Merge completed work
await manager.merge_completed(worktree)

# Cleanup worktree
await manager.cleanup_worktree(worktree)

Integration

Used by:
```
ac-session-manager
```
for session isolation
Uses:
```
ac-checkpoint-manager
```
for rollback points

API Reference

See

scripts/workspace_manager.py

for full implementation.