# Ac Workspace Manager

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

- Skill: `diegosouzapw/ac-workspace-manager` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add diegosouzapw/ac-workspace-manager`
- Raw SKILL.md: https://api.skillmd.com/api/skills/diegosouzapw/ac-workspace-manager/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: diegosouzapw (https://skillmd.com/u/diegosouzapw)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/diegosouzapw/ac-workspace-manager

---


# 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

```python
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

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

```python
# 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.