Add real-time WebSocket channels to your Codex workflow. 30 seconds.
Sign up via the agent-signup endpoint. Free tier: 100 MAU, 50 concurrent connections, 10K messages/day, 10 channels.
curl -X POST https://sdk.tyga.run/api/agent-signup \
-H "Content-Type: application/json" \
-d '{"tenantId":"myproject"}'
Add to your .env
ODDSOCKETS_API_KEY=your_api_key_here
Install the Node.js SDK for server-side real-time channels.
npm install oddsockets
Add the following to your project's AGENTS.md so Codex knows how to use OddSockets real-time channels.
# OddSockets Integration
Real-time WebSocket channels via OddSockets SDK. Auth: API key from env.
## Connect
const client = new OddSockets({ apiKey: process.env.ODDSOCKETS_API_KEY });
## Subscribe to a channel
client.channel('my-channel').subscribe(msg => console.log(msg));
## Publish to a channel
client.channel('my-channel').publish({ text: 'Hello!' });
## Presence (who's online)
client.channel('my-channel').presence();
## REST API
- List keys: GET https://sdk.tyga.run/api/keys
- Usage stats: GET https://sdk.tyga.run/api/usage
- Rate limits: GET https://sdk.tyga.run/api/limits
## Infrastructure
- Manager: https://manager1.oddsockets.tyga.network
- Workers: wss://worker1-1.oddsockets.tyga.network, wss://worker1-2.oddsockets.tyga.network
- Dashboard: https://oddsockets.hq.tyga.dev/developer-dashboard
- Docs: https://docsoddsockets.hq.tyga.dev
Ask Codex to work with real-time channels. Try these prompts:
"Add a real-time chat channel to this app using OddSockets""Subscribe to the 'orders' channel and log new events""Publish a notification to the 'alerts' channel""Show who's currently online in the 'lobby' channel""Check my OddSockets usage stats and rate limits"OddSockets has SDKs for every major language and framework.