skills.rest
wisdom-in-a-nutshell
wisdom-in-a-nutshellOFFICIAL
Explore all skills by this author →
WebsiteGitHub

codex-app-server

Implement and review Codex App Server integrations using JSON-RPC protocol references and local probes.

25|1|Updated Feb 10, 2026
Search Tags:#integration#codex#protocol#streaming#json-rpc#app-server#ide extension
One-click install
npx skills add https://github.com/wisdom-in-a-nutshell/agents --skill codex-app-server-wisdom-in-a-nutshell
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codex-app-server
Source: https://github.com/wisdom-in-a-nutshell/agents/tree/main/skills-source/owned/codex-app-server
Command: npx skills add https://github.com/wisdom-in-a-nutshell/agents --skill codex-app-server-wisdom-in-a-nutshell

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Building clients on Codex App Server requires exact knowledge of its JSON-RPC protocol, thread/turn/item lifecycle, streaming events, and approval flows, which vary between installed binary versions and evolving official documentation. ## Core Features & Use Cases - Protocol Guidance: Provides durable mental models for the initialize handshake, thread/turn/item lifecycle, streaming deltas, approvals, and stdio/WebSocket transports. - Local Probing: Runs scripts/probe_app_server.py to extract the installed binary's exact request methods, schemas, models, MCP servers, skills, and experimental features. - Use Case: When building an IDE extension on Codex App Server, use this Skill to confirm which methods your local build supports, generate matching TypeScript bindings, and verify behavior against official docs before writing client code. ## Quick Start Use the codex-app-server skill to help me implement a client that starts a thread, sends a turn, and handles streaming item events.

Frequently Asked Questions about codex-app-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate a client with Codex App Server?▼

Send an initialize request with clientInfo over a stdio JSON-RPC connection, then an initialized notification. After the handshake, call thread/start to open a conversation and turn/start to send user input while reading streamed item notifications.

How do I check which methods my installed Codex App Server supports?▼

Run scripts/probe_app_server.py to dump the local JSON Schema and TypeScript bindings and query runtime state like models, MCP servers, and skills. Generated artifacts match the exact version of your installed Codex binary.

When should I use Codex App Server versus the Codex SDK?▼

Use App Server when you need durable threads, approvals, streamed events, and full client-driven interaction such as IDE extensions. Use the Codex SDK for one-shot automation, batch jobs, and CI pipelines instead.

Does Codex App Server support WebSocket transport?▼

Yes, via --listen ws://IP:PORT, but it is experimental and unsupported. Prefer stdio, or restrict WebSocket listeners to loopback or SSH-forwarded connections with token-based authentication.

Why do some App Server methods fail with experimental API errors?▼

Certain methods and fields require initialize.params.capabilities.experimentalApi set to true. Stable clients should avoid these unless the caller explicitly opts in, since experimental behavior can change between versions.

Related Skills

Explore More Software Engineering Skills→
hve4638hve4638

hve-setup

Verify and install Codex CLI and register the MCP server.

Community
Intermediate
AeyeOpsAeyeOps
3

mcp-architect-designer

Design and deploy MCP servers with OAuth 2.1 and Docker.

Official
Advanced
mirzadhammirzadham

mcp-server-patterns

Implements MCP servers with tools, resources, prompts, and stdio or HTTP transports.

Community
Intermediate
storyweaverstoryweaver
37

argus-codex-computer-use

Automate Windows desktop applications via Codex and a local MCP server.

Community
Intermediate