git-paw 0.3.0

Parallel AI Worktrees — orchestrate multiple AI coding CLI sessions across git worktrees
Documentation 
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
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

# Specifications

git-paw uses [OpenSpec](https://github.com/openspec) for formal, testable specifications. Each capability has a dedicated spec file using RFC 2119 keywords (`SHALL`, `MUST`, `SHOULD`) and GIVEN/WHEN/THEN scenarios.

## Specification Index

| Capability | Description |
|------------|-------------|
| [CLI Parsing](#cli-parsing) | Command-line argument parsing and subcommands |
| [CLI Detection](#cli-detection) | Auto-detect AI CLIs on PATH, load custom CLIs |
| [Git Operations](#git-operations) | Validate repos, list branches, manage worktrees |
| [Tmux Orchestration](#tmux-orchestration) | Create sessions, manage panes, apply layout |
| [Session State](#session-state) | Persist and recover session state |
| [Configuration](#configuration) | Parse and merge TOML config files |
| [Interactive Selection](#interactive-selection) | User prompts for mode, branch, and CLI selection |
| [Error Handling](#error-handling) | Unified error types with exit codes |

---

## CLI Parsing

{{#include ../../../openspec/specs/cli-parsing/spec.md}}

---

## CLI Detection

{{#include ../../../openspec/specs/cli-detection/spec.md}}

---

## Git Operations

{{#include ../../../openspec/specs/git-operations/spec.md}}

---

## Tmux Orchestration

{{#include ../../../openspec/specs/tmux-orchestration/spec.md}}

---

## Session State

{{#include ../../../openspec/specs/session-state/spec.md}}

---

## Configuration

{{#include ../../../openspec/specs/configuration/spec.md}}

---

## Interactive Selection

{{#include ../../../openspec/specs/interactive-selection/spec.md}}

---

## Error Handling

{{#include ../../../openspec/specs/error-handling/spec.md}}