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

# tt inbox

Check agent inbox(es).

## Synopsis

```bash
tt inbox <AGENT>         # Check specific agent
tt inbox --all           # Show all agents' inboxes
```

## Description

Shows pending messages in agent inboxes.

`supervisor` and `conductor` are aliases for the same well-known mailbox, so `tt inbox supervisor` and `tt inbox conductor` inspect the conductor-facing queue even when no agent with that literal name exists.

When used with `--all`, displays a summary of pending messages for all agents, categorized by type:
- **[T]** Tasks requiring action
- **[Q]** Queries awaiting response
- **[I]** Informational messages (FYI)
- **[C]** Confirmations/acknowledgments

Messages are added by:
- `tt assign` — Creates a task and sends TaskAssign message
- `tt send` — Sends a custom message

## Arguments

| Argument | Description |
|----------|-------------|
| `[AGENT]` | Agent name to check (optional with `--all`) |

## Options

| Option | Short | Description |
|--------|-------|-------------|
| `--all` | `-a` | Show pending messages for all agents |
| `--town <PATH>` | `-t` | Town directory (default: `.`) |
| `--verbose` | `-v` | Enable verbose logging |

## Examples

### Check Specific Agent

```bash
tt inbox backend
tt inbox supervisor
```

Output:
```
📬 Inbox for 'backend': 3 messages
   [T] 2 tasks requiring action
   [Q] 1 queries awaiting response
   [I] 0 informational
   [C] 0 confirmations

   [T] task 1234: Fix authentication bug in login endpoint
   [Q] question: Should this support OAuth fallback?
```

### View All Agents' Inboxes

```bash
tt inbox --all
```

Output:
```
📋 Pending Messages by Agent:

  backend (Working):
    [T] 2 tasks requiring action
    [Q] 1 queries awaiting response
    [I] 3 informational
    [C] 0 confirmations
    • Fix authentication bug in login endpoint
    • Update database schema for new fields

  reviewer (Idle):
    [T] 1 tasks requiring action
    [Q] 0 queries awaiting response
    [I] 0 informational
    [C] 2 confirmations
    • [T] Review PR #42: Add user validation

  supervisor/conductor (well-known mailbox):
    [T] 0 tasks requiring action
    [Q] 1 queries awaiting response
    [I] 2 informational
    [C] 0 confirmations
    • [Q] question: Product decision needed for rollout timing

Total: 4 actionable message(s)
```

## Comparison with tt status

- `tt status` shows agent states and total inbox counts
- `tt inbox --all` shows message breakdown and previews

## See Also

- [tt send](./send.md) — Send messages to agents
- [tt assign](./assign.md) — Assign tasks (sends TaskAssign message)
- [tt task](./task.md) — Manage individual tasks
- [Messages Concept](../concepts/messages.md)