---

name: fix-codex-reconnecting description: Switch Codex between HTTP-only and WebSocket/default network modes by editing the Codex config. Use when Codex repeatedly retries WebSocket connections, when the user wants to force HTTP, when the user wants to restore the default provider, or when checking the current mode.

Fix Codex Reconnecting

Use this skill to change Codex network mode without touching unrelated settings.

Workflow

1. Read the current ~/.codex/config.toml.
2. Create a timestamped backup before writing.
3. Run scripts/switch_codex_network_mode.ps1 for the actual edit.
4. Preserve unrelated config, plugin, and MCP settings.
5. Treat third-party config managers such as ccswitch as owners of the same file; they can overwrite these changes later.
6. Validate with codex debug models.
7. Tell the user to restart the Codex desktop app.

Modes

• http: set model_provider = "openai_http" and add [model_providers.openai_http] with supports_websockets = false.
• websocket: remove the openai_http override and return to the built-in provider.
• status: report the current mode without modifying files.

User Copy

Use README.md when the user wants a copy-paste prompt instead of installing the skill.

Files

• scripts/switch_codex_network_mode.ps1: applies the mode change with backup handling.
• README.md: user-facing prompts, warnings, and recovery notes.