Skip to main content
subagent CX Codex

websocket-engineer · voltagent/awesome-codex-subagents — Codex subagent: what it does, how to install

websocket-engineer handles WebSocket lifecycles, reconnect logic, message contracts, and state sync across unstable connections in Codex.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/websocket-engineer.toml
Open on GitHub

What websocket-engineer does

websocket-engineer treats WebSocket connections as unreliable transport tied to state synchronization rather than simple request-response flows. When handling a task, it maps the lifecycle and auth flow first, applies the narrowest protocol patch, and verifies edge cases such as message ordering or payload duplication.

The subagent evaluates backpressure, degraded network paths, and silent reuse of stale subscriptions. It runs on the gpt-5.6-sol model. By default, it will not replace an existing transport architecture wholesale unless the parent agent explicitly requests that change.

What it helps with

  • resolve state loss and auth invalidation during reconnects
  • prevent duplicated side effects and message race conditions
  • clarify client and server payload contracts for socket events
  • implement fallback behavior when the socket connection drops

Example prompts for the agent

  • Diagnose subscription drops during client WebSocket reconnects
  • Verify message ordering and idempotency for high-frequency events
  • Implement payload contracts and fallback handling for the socket route

How to install websocket-engineer

Manually: put the files in place

.codex/agents/websocket-engineer.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about websocket-engineer

How to install websocket-engineer in Codex?

Place the agent configuration into .codex/agents/websocket-engineer.toml in your project.

What does websocket-engineer do?

It diagnoses and implements WebSocket state flows, reconnect handling, message deduplication, and payload contracts.

Which model does websocket-engineer rely on?

The subagent configuration specifies the gpt-5.6-sol model.

Source text

websocket-engineer.toml · MIT
# websocket-engineer

Use when a task needs real-time transport and state work across WebSocket lifecycle, message contracts, and reconnect/failure behavior.

Treat WebSocket systems as unreliable transport plus state synchronization, not simple request-response.

Working mode:
1. Map connection lifecycle, subscription/auth flow, and message contract.
2. Implement or diagnose the narrowest protocol/state change.
3. Validate behavior across reconnect, duplication, and ordering edge cases.

Focus on:
- connection open/close/reconnect lifecycle behavior
- auth and subscription-state validity over reconnects
- message ordering, deduplication, and idempotency handling
- backpressure/burst behavior where visible
- fallback behavior when socket path is unavailable
- client/server contract clarity for event payloads

Quality checks:
- verify reconnect path does not duplicate side effects
- ensure stale auth/subscription state is not reused silently
- check one normal stream path and one degraded/unstable network path
- call out protocol assumptions needing integration/load testing

Return:
- affected real-time path and protocol boundary
- implementation or diagnosis
- validation performed
- remaining protocol/state/operational caveats

Do not replace transport architecture wholesale unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Backend and APIs →

websocket-engineer by other authors comes first.

websocket-engineer VoltAgent Community The websocket-engineer subagent for Claude Code designs real-time communication with WebSockets or Socket.IO. It handles presence tracking, rooms, and high-concurrency feeds. CX Codex 472installs websocket-development Mindrally websocket-development — a rule set that steers the agent through building WebSocket servers and clients: connections, messages, scaling, security. CX Codex +1 873installs websocket-implementation aj-geddes websocket-implementation — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode: guides the agent through WebSocket systems — connection handling, message routing, scaling with Redis. CX Codex +1 669installs testing-websocket-api-security mahipal testing-websocket-api-security audits WebSocket API security, checking upgrade handshake authentication, token validation, and CSWSH vulnerabilities. Useful during API security reviews. CX Codex +1 379installs exploiting-websocket-vulnerabilities mahipal exploiting-websocket-vulnerabilities is a Claude Code skill for checking WebSocket authentication, cross-site hijacking, injection, and message handling. It runs during authorized security assessments of applications that use WebSockets. CX Codex +1 316installs bun-websocket-server secondsky A skill packed with Bun WebSocket server patterns: handlers, pub/sub, broadcasting. Handy when you need a chat or real-time streaming without extra libraries. CX Codex +1 411installs competition-websocket-runtime zhaoxuya520 competition-websocket-runtime is a Claude Code skill that inspects WebSocket and SSE handshakes, subscriptions, and frames after the orchestrator runs. CX Codex +1 110installs

From the same set176

The whole set →
django-developer django-developer — a subagent for Django projects that understands models, views, forms, ORM and middleware. Takes on tasks tied to app architecture rather than checklist execution. CX Codex ★ 6,505repo stars csharp-developer csharp-developer is a Codex subagent for C# and .NET. It makes minimal fixes to APIs, service layers, and async flows while preserving contracts and architecture. CX Codex ★ 6,505repo stars cpp-pro cpp-pro — a C++ subagent for memory ownership, concurrency, performance-sensitive paths, and systems integration. Use it when a change needs boundary-level analysis. CX Codex ★ 6,505repo stars angular-architect angular-architect — a Codex subagent that owns Angular tasks involving component design, dependency injection, routing, signals, and enterprise application structure. CX Codex ★ 6,505repo stars ui-fixer The ui-fixer subagent applies small patches to reproduced UI bugs. Use it when the fix should stay close to the owning component and avoid unrelated refactoring. CX Codex ★ 6,505repo stars ui-designer ui-designer — a subagent that designs interfaces and interactions before coding. Delivers concrete recommendations on layout, component states, and accessibility—in a form ready to implement. CX Codex ★ 6,505repo stars mobile-developer The mobile-developer subagent for Codex implements and debugs mobile features amid device constraints, lifecycle transitions, and degraded network conditions. CX Codex ★ 6,505repo stars microservices-architect microservices-architect maps service boundaries, contracts, and failure paths. Use it to review a distributed design or plan a change to service ownership. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open