Skip to content

Commit 3ccd152

Browse files
Simplify README and skill docs
Same-machine no longer a special case — auto IDs handle it. Drop WALKIE_ID section from skill (agents never need it). Trim changelog to essentials. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent e8868ff commit 3ccd152

2 files changed

Lines changed: 10 additions & 42 deletions

File tree

README.md

Lines changed: 10 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -21,33 +21,18 @@ AI agents are isolated. When two agents need to collaborate, there's no simple w
2121

2222
**Agent A** (on any machine):
2323
```bash
24-
walkie create ops-room --secret mysecret
24+
walkie create ops-room -s mysecret
2525
walkie send ops-room "task complete, results ready"
2626
```
2727

28-
**Agent B** (on any other machine):
28+
**Agent B** (on any other machine, or a different terminal on the same machine):
2929
```bash
30-
walkie join ops-room --secret mysecret
30+
walkie join ops-room -s mysecret
3131
walkie read ops-room
3232
# [14:30:05] a1b2c3d4: task complete, results ready
3333
```
3434

35-
## Same machine
36-
37-
Two agents on the same machine can talk through the same daemon using `WALKIE_ID`:
38-
39-
```bash
40-
# Agent A
41-
export WALKIE_ID=alice
42-
walkie create ops-room --secret mysecret
43-
walkie send ops-room "hello from alice"
44-
45-
# Agent B (same machine, different terminal)
46-
export WALKIE_ID=bob
47-
walkie join ops-room --secret mysecret
48-
walkie read ops-room
49-
# [14:30:05] alice: hello from alice
50-
```
35+
Works the same whether agents are on the same machine or different continents.
5136

5237
## Commands
5338

@@ -101,25 +86,18 @@ Install the skill and any agent with shell access can create channels, send mess
10186

10287
### 1.3.0
10388

104-
- **Removed `--as` flag**`WALKIE_ID` env var is the only way to set explicit sender names. Eliminates mixed-identity bugs where `--as` was used inconsistently across commands
105-
- **Stale daemon recovery** — cleans up stale socket and PID files before spawning a new daemon, with better error messages pointing to `~/.walkie/daemon.log`
89+
- **Simplified CLI** — removed `--as` flag, `WALKIE_ID` env var is the only explicit identity option
90+
- **Stale daemon recovery** — cleans up stale socket/PID files before spawning, better error messages
10691

10792
### 1.2.0
10893

109-
- **Auto-unique subscriber IDs** — each terminal session automatically gets a unique subscriber ID derived from the terminal session (supports Terminal.app, iTerm2, tmux, WezTerm, X11). Two agents in different terminals just work — no `WALKIE_ID` setup needed
110-
- `WALKIE_ID` still works as an explicit override for human-readable sender names
111-
- **`--wait` blocks indefinitely**`walkie read --wait` now blocks until a message arrives with no default timeout. Add `--timeout N` for an optional deadline
112-
- **Orphaned waiter fix** — interrupted `read --wait` no longer silently drops messages
94+
- **Auto-unique subscriber IDs** — each terminal session gets a unique ID automatically. Same-machine agents just work with no setup
95+
- **`--wait` blocks indefinitely**`walkie read --wait` blocks until a message arrives. Add `--timeout N` for a deadline
11396

11497
### 1.1.0
11598

116-
- **Same-machine multi-agent routing** — multiple agents on one machine can communicate through the same daemon using `WALKIE_ID` env var
117-
- Per-subscriber message buffers — each identity gets its own buffer, senders never see their own messages
118-
- `walkie status` now shows subscriber count per channel
119-
- `walkie leave` only tears down the P2P connection when all local subscribers have left
120-
- New `same-machine-collab.sh` template
121-
- Updated monitoring template to use `WALKIE_ID=monitor` to avoid stealing messages
122-
- Comprehensive docs: recovery, group channels, fire-and-forget semantics, error cases
99+
- **Same-machine multi-agent routing** — per-subscriber message buffers, senders never see their own messages
100+
- `walkie status` shows subscriber count, `walkie leave` only tears down P2P when all subscribers leave
123101

124102
## License
125103

skills/walkie/SKILL.md

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -42,16 +42,6 @@ walkie read room
4242
# [14:30:05] 5cc112d0: hello from alice
4343
```
4444

45-
## Named identities (optional)
46-
47-
For human-readable sender names, set `WALKIE_ID`:
48-
49-
```bash
50-
export WALKIE_ID=alice # all commands in this shell use "alice"
51-
```
52-
53-
Without this, a short hash of your terminal session is used automatically.
54-
5545
## Behavior to know
5646

5747
- `delivered: 0` means the message is permanently lost — verify `delivered > 0` for critical messages

0 commit comments

Comments
 (0)