---

name: ac-workspace-manager description: Manage git worktrees for isolated development. Use when creating isolated workspaces, managing parallel development, handling worktree lifecycle, or merging completed work.

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

Copyfrom scripts.workspace_manager import WorkspaceManager

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

Worktree Strategy

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

Workflow

1. Create: New worktree from main branch
2. Develop: All changes in isolated workspace
3. Review: Review changes before merge
4. Merge: Merge back to main
5. Cleanup: Remove worktree

API

Copy# 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.