claude-compose 0.5.0

Real-time log viewer for Claude Code Agent Teams
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

# claude-compose

`docker compose logs` for Claude Code Agent Teams.

```
$ claude-compose logs -f
[08:46:49] team-lead  │ Let me break this into three parallel tasks...
[08:46:51] backend    │  Read: src/api/handlers.rs
[08:46:51] frontend   │  Glob: **/*.tsx
[08:46:52] backend    │ Found the issue — missing error handler on line 42
[08:46:53] frontend   │  → team-lead: Component tree analysis complete
[08:46:55] tests      │  Bash: cargo test
[08:46:58] tests      │  Task #3 → completed
```

## Install

```
cargo install claude-compose
```

## Commands

```bash
claude-compose logs -f                        # follow all agents
claude-compose logs -f backend frontend       # filter by agent
claude-compose logs --type assistant           # filter by message type
claude-compose logs --json | jq '.agent_name'  # pipe-friendly
claude-compose ps                              # agent status table
claude-compose ps --json                       # JSON output for scripting
claude-compose up                              # start team in tmux
claude-compose down                            # stop team
```

No hooks, no database, no web server. Reads `~/.claude/` directly.

## License

MIT