doctor
Check that Codex is installed, authenticated, and reachable through app-server; list models, effort tiers, presets, and the shared server state. Use for "/codex-bridge:doctor" and when Codex runs fail.
Source facts
- Repository
- collisionengineers/claude-using-codex-skill
- Last source activity
- September 3, 2026 at 15:39
- Detected SKILL.md language
- English
- Stars
- 0
- Forks
- 0
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- doctor
- description
- Check that Codex is installed, authenticated, and reachable through app-server; list models, effort tiers, presets, and the shared server state. Use for "/codex-bridge:doctor" and when Codex runs fail.
- argument-hint
- [--server start|stop|status]
- disable-model-invocation
- true
- allowed-tools
- Bash(node:*), Read
Diagnose the codex-bridge runtime.
## Steps
1. Run `node "${CLAUDE_PLUGIN_ROOT}/scripts/codex-bridge.mjs" doctor`. The human-readable report is on stderr; the exit code is 0 when healthy.
2. If `$ARGUMENTS` contains `--server start|stop|status`, also run `codex-bridge.mjs server start|stop|status` and report the result. The shared server is a loopback `codex app-server --listen ws://127.0.0.1:<port>`; runs use it with `--via ws` or when `shared_server: true` is set in `.claude/codex-bridge.local.md`.
3. Summarise: version, auth type and plan, default model and available effort tiers, warnings. For "not installed" say `npm install -g @openai/codex`; for "not logged in" say `codex login`.
4. Mention where project settings go (`.claude/codex-bridge.local.md`, template in the plugin's `examples/`) only if the user asks how to change defaults.
View on GitHub