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
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

# tt reset

Reset all town state, clearing agents, tasks, and messages from Redis.

## Synopsis

```bash
tt reset [OPTIONS]
```

## Description

Performs a complete reset of the town's Redis state. This is useful when you want to start fresh without reinitializing the entire town, or when cleaning up after a failed run.

**⚠️ Warning:** This operation cannot be undone. All agents, tasks, and messages will be permanently deleted.

## Options

| Option | Description |
|--------|-------------|
| `--force` | Skip the confirmation prompt and proceed immediately |
| `--agents-only` | Only reset agent-related state (agents and inboxes), preserving tasks and backlog |
| `--town <PATH>` | Town directory (default: `.`) |
| `--verbose` | Enable verbose logging |

## Examples

### Full Reset (with confirmation)

```bash
tt reset
```

Output:
```
🗑️  Resetting town 'my-project'
   This will delete:
   - 3 agent(s)
   - 12 task(s)
   - 2 backlog item(s)

⚠️  This action cannot be undone!
   Run with --force to confirm: tt reset --force
```

### Full Reset (immediate)

```bash
tt reset --force
```

Output:
```
🗑️  Resetting town 'my-project'
   This will delete:
   - 3 agent(s)
   - 12 task(s)
   - 2 backlog item(s)

✅ Reset complete: deleted 47 Redis keys
   Run 'tt spawn <name>' to create new agents
```

### Agents-Only Reset

Reset just the agents while preserving tasks and backlog:

```bash
tt reset --agents-only --force
```

Output:
```
🗑️  Resetting agents in town 'my-project'
   This will delete:
   - 3 agent(s) and their inboxes
   Tasks and backlog will be preserved.

✅ Reset complete: deleted 12 Redis keys (agents only)
   Run 'tt spawn <name>' to create new agents
```

## Use Cases

| Scenario | Command |
|----------|---------|
| Start completely fresh | `tt reset --force` |
| Replace agents but keep tasks | `tt reset --agents-only --force` |
| Preview what will be deleted | `tt reset` (no --force) |

## What Gets Deleted

### Full Reset (`tt reset --force`)
- All registered agents (`tt:<town>:agent:*`)
- All agent inboxes (`tt:<town>:inbox:*`)
- All tasks (`tt:<town>:task:*`)
- All backlog items (`tt:<town>:backlog`)
- Agent activity logs

### Agents-Only Reset (`tt reset --agents-only --force`)
- All registered agents (`tt:<town>:agent:*`)
- All agent inboxes (`tt:<town>:inbox:*`)
- Agent activity logs

Tasks and backlog are preserved.

## Recovery

If you accidentally reset:
- If you previously ran `tt save`, you may be able to `tt restore` from the AOF file
- If tasks were synced to `tasks.toml`, you can `tt sync push` to recreate them

## See Also

- [tt init](./init.md) — Initialize a new town
- [tt spawn](./spawn.md) — Create agents after reset
- [tt save](./save.md) — Save state before reset
- [tt restore](./restore.md) — Restore from saved state