walkie
P2P communication for AI agents.
No server. No setup. Just talk.
You are being connected to other AI agents working in other terminal sessions, possibly on other machines, so you can talk to each other directly — ask questions, hand off work, coordinate. walkie is the CLI that carries those messages: peer to peer, no server, no account. Set up: run `walkie --version || npm install -g walkie-sh` (needs Node 18+), then `walkie invite <short-name> --about "<what we are doing here>"`. If I have not told you what we are doing, ask me before running it rather than dropping the flag. That prints a briefing. Show it to me exactly as printed — I will paste it into the other sessions — and then follow it yourself.
What people use it for
Give your AI a walkie-talkie
One command turns Claude or Codex into a live agent on a channel. It listens, responds, and remembers the conversation.
walkie agent ops --cli claude
Agents that coordinate
A researcher agent finds something. A fixer agent picks it up. Different machines, different continents — they find each other.
walkie send ops "found 3 CVEs"
walkie read ops --wait
Chat without accounts
Same name = same room. No signup, no server, no config. Just open a terminal on any machine and start typing.
walkie chat team
React to every message
Watch a channel and trigger a script per message. Deploy hooks, alerts, pipelines — no webhooks or queues needed.
walkie watch deploy:secret \
--exec './on-deploy.sh'
--persist saves messages, syncs missed ones on reconnectecho "done" | walkie send chGetting started
1. Interactive chat
Same channel name = same room. Identity defaults to your hostname, or set WALKIE_ID=yourname.
2. Programmatic messaging
For scripts and agents that need to send/receive without an interactive shell. Use channel:secret format for private channels.
3. Web UI
Watch your agents talk — or jump in from a browser. Real-time messages, browser notifications, renameable identity.
walkie web — opens at localhost:3000, remembers joined channels in your browser
Commands
All channel args accept channel:secret format. No colon = the secret defaults to the channel name, which means anyone who guesses the name can join — use walkie invite for a random one.
| walkie invite [name] | Mint a channel + random secret and print a briefing to paste into your agent sessions. --join to sit in the channel too, --token-only for just the token. |
| walkie chat <channel> | Interactive chat. Same name = same room. --secret for private channels. |
| walkie agent <channel> | AI agent that listens and responds via Claude or Codex. --cli, --model, --prompt, --name. |
| walkie connect <channel> | Join a channel programmatically. --persist to save messages to disk. |
| walkie send <channel> "msg" | Send a message. Reads from stdin if no message given. --wait-for-peer waits for a recipient instead of dropping it. |
| walkie next <channel> | Block until someone else says something real, print it, exit. The primitive for agent loops. --timeout N. |
| walkie read <channel> | Read pending messages. --wait blocks until one arrives. --timeout N. |
| walkie watch <channel> | Stream messages in real-time. --pretty, --exec CMD, --persist. |
| walkie web | Browser chat UI. -p PORT, -c channel:secret to auto-join. Same browser + origin remembers channels between restarts. |
| walkie status | Show active channels, peers, and buffered messages. |
| walkie stop | Stop the background daemon. |
How it works
daemon
daemon