oddsockets

Agent-first CLI for OddSockets real-time messaging.

Signup, publish, subscribe, presence, API key management — all from the command line. Zero dependencies.

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

Agent Integration

Add to your CLAUDE.md, .cursorrules, .clinerules, or .windsurfrules:

## OddSockets
Use the `oddsockets` CLI for real-time messaging.
Key is in .oddsockets/config.json (auto-loaded).

oddsockets status                           # cluster health
oddsockets publish my-channel "message"     # send message
oddsockets subscribe my-channel             # live tail
oddsockets presence my-channel              # who's online
oddsockets keys                             # list API keys

Commands

Setup

Command	Description
oddsockets signup <app> [--email x] [--local]	Sign up, get instant API key
oddsockets login --key KEY [--local]	Save existing API key
oddsockets logout [--local]	Clear config
oddsockets me	Account info + plan
oddsockets status	Cluster health + platform stats

Messaging

Command	Description
oddsockets publish <channel> "message"	Publish message
oddsockets publish <channel> --file data.json	Publish from file
oddsockets subscribe <channel>	Live tail (Ctrl+C to stop)
oddsockets history <channel> [--limit 10]	Message history
oddsockets presence <channel>	Channel members

Channels

Command	Description
oddsockets channels	List channels
oddsockets channel create <name>	Create channel
oddsockets channel delete <name>	Delete channel

API Keys

Command	Description
oddsockets keys	List API keys
oddsockets key create "name"	Create new key
oddsockets key revoke <id>	Revoke key

Flags

• --json — Machine-readable JSON output (every command)
• --key KEY — Override API key for one command
• --local — Use project-local config (.oddsockets/)
• --help — Help

Config Priority

1. --key flag
2. ODDSOCKETS_API_KEY environment variable
3. .oddsockets/config.json in project directory
4. ~/.oddsockets/config.json in home directory

Free Tier

• 100 MAU, 50 concurrent connections
• 10,000 messages/day, 10 channels
• 24h message history

Links

• Documentation
• Dashboard
• GitHub