Codex Desktop Doctor, developed by Wokao4360 Rgb, is a specialized repair and diagnostic toolkit. Designed for Windows-based OpenAI Codex Desktop environments, it helps users troubleshoot various operational issues. This free tool focuses on maintaining the stability and functionality of Codex within its ecosystem, addressing concerns related to plugins, connectivity, and performance. Its integration within the OpenAI Codex CLI makes it a readily accessible utility for users encountering problems with their Codex setup. The tool is built on Node.js, indicating a foundation in JavaScript or TypeScript.

What does Codex Desktop Doctor connect to?

Codex Desktop Doctor connects to several key components within the OpenAI Codex ecosystem. It establishes links with OpenAI Codex Desktop plugins, Model Context Protocol (MCP) OAuth providers, and local API providers. Additionally, it interacts with session visibility services, ensuring a holistic view of the Codex environment. The Model Context Protocol is an open standard designed to enable AI applications like Codex to securely interface with external data sources, developer tools, and various APIs.

Core features and tools

This toolkit exposes a primary callable tool, codex doctor, which operates within the Codex CLI. This command serves as a central point for running diagnostics across several critical areas. Its functions include assessing startup sequences, evaluating connectivity to ensure proper communication, and analyzing performance metrics to identify bottlenecks or inefficiencies. It is a dedicated utility for maintaining the health of the Codex Desktop environment.

Who is it for?

Codex Desktop Doctor is intended for Windows Codex Desktop users who are experiencing operational issues. This includes problems with Codex Desktop plugins, Model Context Protocol (MCP) OAuth, local API providers, or session visibility. It is particularly useful for those who need to diagnose why Codex cannot control applications like Chrome or other Windows programs, even when Computer Use is enabled. Skip this if you are not a Windows Codex Desktop user experiencing these specific types of issues.

How to get started

Access is granted through a standard OAuth authorization flow. The setup requires launching a preferred Codex client (Desktop app, CLI, or IDE extension) and following the instructions to sign in via a browser, typically involving a ChatGPT account. The tool primarily supports the STDIO (Standard Input/Output) transport protocol.

Use cases

• Running diagnostics for startup, connectivity, and performance issues within the Codex environment.
• Troubleshooting problems where Codex cannot control applications like Chrome or Windows apps, even when Computer Use is enabled.
• Diagnosing issues that arise after a Codex update or restart, such as failures in Chrome or Computer Use functionality.

Codex Desktop Doctor offers a targeted diagnostic solution for Windows Codex Desktop users. It addresses common issues related to plugins, connectivity, and application control within the Codex environment. Its integration with the Codex CLI provides a direct path to troubleshooting, utilizing standard input/output for interaction. This tool is a valuable asset for maintaining a functional Codex setup. Try running "codex doctor" in the Codex CLI to diagnose startup issues.