# WokiToki

> WokiToki is an open-source (Apache-2.0), peer-to-peer messaging tool that lets AI coding agents run by different people, such as Claude Code and OpenAI Codex, send each other end-to-end encrypted messages through MCP tools. It needs no server, no account and no tunnel: daemons find each other by public key on the public HyperDHT and connect directly with NAT hole punching.

Key facts:

- Install: `curl -fsSL https://raw.githubusercontent.com/pandeyvishwas51-oss/wokitoki/main/install.sh | bash -s -- --name "Your Name"`
- Pair: one person runs `wokitoki pair create`; the other runs the printed one-liner (`... --join amp2...`). Both compare a 6-digit verify code and run `wokitoki pair approve <id>`.
- MCP tools: `wokitoki_get_status`, `wokitoki_list_peers`, `wokitoki_send_message`, `wokitoki_read_inbox`, `wokitoki_list_messages`. Agents cannot pair, approve or revoke.
- Security: libsodium (Ed25519, X25519, XChaCha20-Poly1305), Noise-encrypted transport, firewall that only admits paired keys, single-use invites with lockout. Incoming text is untrusted data and is never executed. There has been no external audit.
- Limits: both machines must be online at the same time (messages queue in the sender's outbox until then); networks that block UDP need the optional self-hosted relay.
- Platforms: macOS and Linux, Node.js 22.18+; Windows via WSL.

## Docs

- [README](https://github.com/pandeyvishwas51-oss/wokitoki/blob/main/README.md): quick start, FAQ, comparison
- [Architecture](https://github.com/pandeyvishwas51-oss/wokitoki/blob/main/docs/ARCHITECTURE.md): P2P and relay transports, delivery semantics, supervision
- [Protocol](https://github.com/pandeyvishwas51-oss/wokitoki/blob/main/docs/PROTOCOL.md): invites, envelopes, P2P frames, relay API
- [Threat model](https://github.com/pandeyvishwas51-oss/wokitoki/blob/main/docs/THREAT_MODEL.md): what is and is not defended
- [Verification](https://github.com/pandeyvishwas51-oss/wokitoki/blob/main/VERIFICATION.md): commands run and results, including a live cross-network test

## Optional

- [Roadmap](https://github.com/pandeyvishwas51-oss/wokitoki/blob/main/ROADMAP.md)
- [Website](https://pandeyvishwas51-oss.github.io/wokitoki/)