thor 0.2.0

Git worktree dashboard with AI agent coordination
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131

# Grove

A terminal UI for managing git worktrees with integrated AI agent notifications.

## Features

- **TUI Dashboard** - Navigate worktrees and notifications with vim-style keys
- **Agent Notifications** - AI agents can report task completion status
- **TMUX Integration** - Popup support for seamless workflow
- **Shell Integration** - Automatic `cd` to selected worktree

## Installation

### From Source

```bash
git clone https://github.com/yourusername/grove.git
cd grove
cargo install --path crates/grove-cli
```

### Shell Integration

Add to your `~/.zshrc`:

```bash
source /path/to/grove/scripts/grove.zsh
```

This enables:
- `grove` - Launch TUI with cd integration
- `grove-popup` - TMUX popup launcher

### TMUX Integration

Add to your `~/.tmux.conf`:

```bash
bind g display-popup -E -w 80% -h 70% -T " grove " "grove popup"
```

Now `prefix + g` opens grove in a popup.

## Usage

### TUI

```bash
grove          # Open TUI
grove popup    # Open TUI (always outputs path for shell integration)
```

**Keybindings:**

| Key | Action |
|-----|--------|
| `j`/`k` | Navigate up/down |
| `Tab` | Switch between Worktrees/Inbox |
| `Enter` | Switch to selected worktree |
| `n` | Create new worktree |
| `d` | Delete worktree |
| `r` | Mark notification as read |
| `a` | Archive notification |
| `?` | Toggle help |
| `q`/`Esc` | Quit |

### CLI Commands

```bash
grove list [--json]              # List worktrees
grove new <branch> [-b base]     # Create worktree
grove remove <branch> [-f]       # Remove worktree
grove switch <branch>            # Output worktree path

grove notify send --status success --summary "Done"
grove notify list [--unread] [--json]
grove notify read <id>
grove notify archive <id>
```

## Configuration

Create `~/.config/grove/config.toml`:

```toml
[general]
worktree_dir = ".worktrees"
default_base = "main"

[theme]
selected_bg = "#3b4252"
success = "#a3be8c"
failure = "#bf616a"
warning = "#ebcb8b"
muted = "#4c566a"
highlight = "#88c0d0"
```

## Agent Integration

AI agents can send notifications after completing tasks:

```bash
grove notify send \
    --status success \
    --summary "Implemented feature X" \
    --branch feature/x \
    --agent claude-code \
    --commit abc1234
```

See [docs/agent-integration.md](docs/agent-integration.md) for details.

## Project Structure

```
grove/
├── crates/
│   ├── grove-core/    # Git operations, config
│   ├── grove-notify/  # Notification system
│   ├── grove-tui/     # Terminal UI
│   └── grove-cli/     # CLI binary
├── scripts/
│   └── grove.zsh      # Shell integration
└── docs/
    └── agent-integration.md
```

## License

MIT