explaingit

zhanyuyue7-dotcom/codex-computer-use

13PowerShellAudience · developerComplexity · 2/5Setup · easy

TLDR

An unofficial repair skill for OpenAI's Codex Desktop on Windows that diagnoses and fixes broken Computer Use and Chrome control features, covering corrupted caches, native messaging failures, Chrome profile mismatches, and permission issues.

Mindmap

mindmap
  root((codex-computer-use))
    What it does
      Diagnose Codex Desktop
      Fix Computer Use feature
      Repair Chrome control
    Problem Categories
      Corrupted plugin cache
      Native messaging failure
      Chrome profile mismatch
      Windows permission issues
    Usage Methods
      Natural language via skill
      PowerShell scripts manual
    Repair Actions
      Cache rebuild
      Registry entry fix
      Config file backup
    Scope
      Windows only
      Unofficial community tool
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Fix Codex Desktop's Computer Use feature when it appears in the interface but doesn't actually work on Windows.

USE CASE 2

Repair the native messaging connection between Codex Desktop and Chrome when Chrome control is broken.

USE CASE 3

Run a diagnostic check on your Codex setup to identify whether the issue is a corrupted cache, a profile mismatch, or a permission problem.

USE CASE 4

Apply targeted repairs to Codex's plugin cache and Chrome extension settings without reinstalling Codex or touching protected system folders.

Tech stack

PowerShellWindowsChrome

Getting it running

Difficulty · easy Time to first run · 5min

Clone into Codex Desktop's skills folder and restart Codex, PowerShell scripts can also be run manually without the skill.

In plain English

This repository is a skill for OpenAI's Codex Desktop application on Windows, written to diagnose and fix a specific set of problems related to its Computer Use and Chrome control features. The README is in Chinese. The project was made by a community member, not by OpenAI, and is clearly labeled as an unofficial repair tool. The problems it targets are cases where the Computer Use or Any App controls inside Codex Desktop appear in the interface but do not actually work. Common causes include a corrupted or missing plugin cache, a broken native messaging connection between Codex and the Chrome browser, a mismatch between the Chrome profile that Codex expects and the one where the extension is actually installed, and Windows permission issues when Codex is installed as a Store app that blocks certain file copy operations. To install the skill, you clone this repository into a specific folder inside your user profile directory where Codex Desktop looks for skills. After restarting Codex, you can type a natural-language request asking it to check and fix the Computer Use and Chrome control problems, and Codex will follow the skill's diagnostic steps automatically. The skill checks the Codex package version, the local configuration file, the plugin cache, the native messaging manifest and registry entries, and whether the Chrome profile assignment is consistent before deciding what to fix. For users who prefer running commands directly, the repository also includes PowerShell scripts you can execute manually. One script verifies the Computer Use setup without making changes, another runs the full repair, and a third handles Chrome control specifically. A separate flag on the Chrome repair script opens the extension installation page directly in the browser. The skill avoids aggressive actions by default: it does not touch the protected WindowsApps folder, does not uninstall or reinstall Codex, and backs up the configuration file before modifying it. More invasive patching steps are available as a last resort only.

Copy-paste prompts

Prompt 1
I've installed the codex-computer-use skill in Codex Desktop. What natural-language request should I type to trigger the full diagnostic and repair?
Prompt 2
My Codex Desktop Chrome control isn't working. Walk me through running the PowerShell repair script manually and what it checks.
Prompt 3
How does the native messaging manifest repair in this skill work, and what registry entries does it check to fix the Codex-to-Chrome connection?
Prompt 4
The skill reports a Chrome profile mismatch for my Codex extension. How does the repair fix the profile assignment?
Prompt 5
What does the verify-only PowerShell script check without making changes, and how do I read its output to spot the issue?
Open on GitHub → Explain another repo

← zhanyuyue7-dotcom on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.