wagner 0.5.3

AI agent monitoring CLI tool with TUI
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
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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156

# Wagner

Wagner is a tmux-based orchestrator for running AI agents across one or many repos.

It supports three primary workflows:
- quick launch in the current repo (`wagner claude`, `wagner codex`)
- attached multi-repo sessions without worktrees (`wagner start`)
- managed tasks with isolated git worktrees (`wagner new`)

## Install

```bash
# Recommended
curl -fsSL https://raw.githubusercontent.com/DeevsDeevs/wagner/main/install.sh | sh

# Cargo
cargo install wagner

# Nix
nix profile install github:DeevsDeevs/wagner
```

## Requirements

- `tmux`
- `git`
- at least one agent CLI (`claude` and/or `codex`)

## Quick Start (Simplest)

From inside any git repo:

```bash
wagner claude      # start/attach a Claude task for current directory
wagner codex       # start/attach a Codex task for current directory
wagner terminal    # start/attach a plain terminal task
```

Optional custom task name:

```bash
wagner claude -n my-task
```

Useful follow-ups:

```bash
wagner ls
wagner a my-task
wagner detach my-task
```

## Multi-Repo Without Worktrees

```bash
# auto-detect repo(s) from current directory
wagner start

# explicit paths
wagner start ~/repos/frontend ~/repos/backend -n fullstack

# stop tracking (repos stay untouched)
wagner detach fullstack
```

## Managed Worktree Tasks

```bash
# single repo (auto-detected from cwd)
wagner new my-feature

# workspace-based multi-repo task
wagner workspace add app frontend:~/repos/frontend backend:~/repos/backend
wagner new my-feature -w app
```

Cleanup:

```bash
wagner rm my-feature        # remove task/worktrees
wagner rm my-feature -f     # also remove task branches
```

## Sync Workspace Repos

Fetch latest changes for all repos in a workspace before creating tasks:

```bash
wagner sync              # fetch all workspace repos
wagner sync app          # fetch repos in specific workspace
```

## Daemon + Remote Control

Start daemon:

```bash
wagner daemon start
wagner daemon status
wagner daemon restart
wagner daemon stop
```

Once daemon is running, these commands use IPC:

```bash
wagner status [task]
wagner send <task> "message"
wagner approve [task] [pane]
wagner reject <task> [pane]
wagner output <task> [pane] -l 120
wagner resume <task> [pane]
wagner add [task] [repo] [--name pane-name] [--agent claude|codex|terminal]
```

## Telegram Adapter (Optional)

Configure `~/.config/wagner/config.json`:

```json
{
  "daemon": {
    "telegram": {
      "bot_token": "<telegram_bot_token>",
      "chat_id": 123456789,
      "allowed_users": [123456789],
      "notify_waiting": true,
      "rate_limit_ms": 50
    }
  }
}
```

Then run `wagner daemon start`.

## Minimal Config

Default config path: `~/.config/wagner/config.json`

```json
{
  "tasks_root": "~/tasks",
  "repos_root": "~/repos",
  "default_agent": "claude",
  "diff_base": "main"
}
```

## More Docs

- Architecture: `docs/architecture.md`
- Contributor map: `CLAUDE.md`

## License

MIT