oddsockets

Real-time messaging for coding agents — pub/sub, presence and history your agent provisions itself, from the command line.

Prototype in one command. Ship the same channels to production — no rewrite.

Your agent can write the app but can't give it a real-time backbone without you stopping to wire up a messaging service. oddsockets is the CLI the agent runs itself: one install, and it signs up, mints its own key, and starts publishing and subscribing to live channels — the same channels that carry your production traffic. Zero dependencies.

Works with: Claude Code · Cursor · Cline · Windsurf · Aider · Codex · any terminal

Signup to your first real-time message in 60 seconds — watch the full demo.

See it live

Each demo below is a real CLI session — a throwaway account, a real key, real messages over the live cluster — stitched to the developer dashboard showing that same traffic. Click any tab for the full-res video.

Signup → first message	Live pub/sub	Who's online	Agent integration
Fresh app, first message in seconds	One channel, two messages, instant	Live member list	publish + history in one line

Watch the full set on oddsockets.com →

Install

npm install -g oddsockets

Quick Start

# 1. Sign up (instant API key, no email verification)
oddsockets signup my-app --local

# 2. Publish a message
oddsockets publish my-channel "Hello from the CLI!"

# 3. Subscribe (live tail)
oddsockets subscribe my-channel

# 4. Check who's online
oddsockets presence my-channel

Pub/sub — one channel, real-time

The core primitive: publish to a channel, subscribe to tail it live. Every subscriber gets every message the instant it lands — no polling, no queue to run.

oddsockets subscribe room-42 &                     # live tail in the background
oddsockets publish room-42 "hello from the CLI"    # arrives on the tail instantly
oddsockets publish room-42 --file payload.json     # publish structured data from a file

Presence — who's online, right now

Ask any channel who's connected. Presence is tracked server-side and updates in real time as clients join and leave.

oddsockets subscribe lobby &     # join the channel
oddsockets presence lobby        # live member list

History — replay what you missed

Channels keep a rolling message history, so a client that connects late (or your agent after a context reset) c

... View full README on GitHub