tinytown 0.10.0

A simple, fast multi-agent orchestration system using Redis for message passing
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

# tt prune

Remove stopped or stale agents from Redis.

## Synopsis

```bash
tt prune [OPTIONS]
```

## Description

Removes agents that are in a terminal state (Stopped or Error) from Redis. This cleans up agent records after they've finished or failed. Useful for managing long-running towns where many agents have come and gone.

## Options

| Option | Short | Description |
|--------|-------|-------------|
| `--all` | | Remove ALL agents, not just stopped ones |
| `--town <PATH>` | `-t` | Town directory (default: `.`) |
| `--verbose` | `-v` | Enable verbose logging |

## Examples

### Prune Only Stopped Agents

```bash
tt prune
```

Output:
```
🗑️  Removed worker-1 (abc123...) - Stopped
🗑️  Removed worker-2 (def456...) - Error
✨ Pruned 2 agent(s)
```

### Remove All Agents

```bash
tt prune --all
```

⚠️ **Warning:** This removes ALL agents including active ones.

## Common Workflow

After recovering orphaned agents, prune them:

```bash
# First, recover any orphaned agents (marks them as stopped)
tt recover

# Then remove stopped agents from Redis
tt prune
```

## See Also

- [tt recover](./recover.md) — Detect and clean up orphaned agents
- [tt reset](./reset.md) — Full town reset
- [tt kill](./kill.md) — Stop a specific agent