AgentSkillsCN

codex-jsonrpc

使用 JSON-over-TCP、以换行符分隔的 JSON-RPC 风格协议，实现或调试 CodexMonitor 远程后台守护进程与客户端。适用于构建 TypeScript/Node.js 守护进程、对接 Codex 应用服务器代理方法、完成身份验证握手、管理工作空间与工作树，或开发配套的客户端应用。

SKILL.md
--- frontmatter
name: codex-jsonrpc
description: Implement or debug the CodexMonitor remote backend daemon and client using the JSON-over-TCP, line-delimited JSON-RPC-ish protocol. Use when building the TypeScript/Node.js daemon, wiring Codex app-server proxy methods, auth handshake, workspace/worktree management, or the matching client.

Codex JSON-RPC Daemon

Overview

Use this skill to implement a TypeScript/Node.js remote backend daemon and client that are protocol-compatible with the Rust CodexMonitor implementation. The full specification is in references/codex-jsonrpc-typescript-spec.md.

Implementation workflow

  1. •Implement TCP server with line-delimited JSON framing.
  2. •Add auth gating (auth first) and error responses.
  3. •Implement workspace/worktree CRUD and persistence.
  4. •Spawn and proxy codex app-server sessions per workspace.
  5. •Broadcast app-server events to all authenticated clients.
  6. •Implement the TypeScript client wrapper for calls and notifications.
  7. •Verify method names, params, and error messages match spec.

Protocol checklist

  • •One JSON object per line; ignore blank or invalid JSON.
  • •No response if request has no numeric id.
  • •Responses are {id,result} or {id,error:{message}} with exact messages.
  • •Notifications: app-server-event (snake workspace_id) and optional terminal-output.

Codex app-server proxy rules

  • •Initialize app-server on spawn and emit codex/connected event.
  • •Map accessMode to sandboxPolicy and approvalPolicy exactly.
  • •Proxy thread/turn/review/model/skills methods as raw JSON.

Persistence

  • •workspaces.json and settings.json in dataDir.
  • •Atomic writes after each mutation.

References

  • •references/codex-jsonrpc-typescript-spec.md contains the full spec.