workz 0.8.0

Zoxide for Git worktrees — zero-config sync, fuzzy switching, AI-ready
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

# workz MCP Integration

workz exposes all its operations as MCP tools so AI agents can manage worktrees directly.

## Setup

```bash
claude mcp add workz -- workz mcp
```

Or add manually to your Claude Code config (`~/.claude/settings.json`):

```json
{
  "mcpServers": {
    "workz": {
      "command": "workz",
      "args": ["mcp"]
    }
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `workz_start` | Create a worktree with auto-synced deps and env |
| `workz_list` | List all worktrees as JSON |
| `workz_status` | Rich status: branch, dirty state, last commit |
| `workz_sync` | Sync symlinks/env into an existing worktree |
| `workz_done` | Remove a worktree (with optional force) |
| `workz_conflicts` | Detect files modified in multiple worktrees |

## Parallel Agent Workflow

To run parallel agents on independent tasks:

1. Use `workz_start` to create isolated worktrees for each task
2. Each agent gets its own branch, deps, env — no interference
3. Use `workz_conflicts` to check for overlapping file changes before merging
4. Use `workz_done` to clean up when finished