Guide agents to restore Codex Desktop local patches and feature toggles (Computer Use, plugins, Fast Mode) after upgrades on Windows
triggers
["restore Codex Desktop patches after upgrade","fix Codex Fast Mode not working on Windows","repair Codex Computer Use missing helper","enable Codex plugins and marketplace","fix Codex browser_use or Chrome control disabled","restore Codex locale and language settings","patch Codex MSIX package on Windows","unlock Codex Any App computer control"]
This skill guides AI agents to restore local patches and feature toggles in Codex Desktop on Windows after upgrades invalidate them. It handles Fast Mode, Computer Use, plugins, browser control, locale settings, and feature gates.
What This Project Does
codex-windows-fast-patch-skill provides PowerShell workflows and scripts to:
Re-apply Windows MSIX patches after Codex Desktop upgrades
Restore Fast Mode (service_tier=priority) in both request paths and settings UI
Keep locale/i18n enabled to prevent language resets
Register and repair local plugin marketplace configurations
Unlock in-app browser, browser pane, and Chrome/browser_use disabled by feature gates
Refresh Windows Computer Use compatibility files
Unlock "Any App" / "任意应用" in Computer Control when region/org-gated
Fix Codex mobile/connection page remote control settings stuck on login
Auto-backup config.toml before overwrites
Auto-update skill from GitHub before each use
Platform: Windows only. Relies on MSIX package structure, PowerShell, Get-AppxPackage, makeappx.exe, signtool.exe, Windows environment variables, and Windows Computer Use helper paths.
Installation
Clone the repository and copy skill files to Codex:
User reports: "Computer Use shows missing-helper-path error"
Agent should:
# Verify current state
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\.codex\skills\codex-windows-fast-patch\scripts\install-computer-use-local.ps1" -VerifyOnly
# If verification fails, install/repair
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\.codex\skills\codex-windows-fast-patch\scripts\install-computer-use-local.ps1"
Restart Codex Desktop after fix.
Pattern 2: Marketplace Corruption
User reports: "codex plugin list throws marketplace manifest error"
Agent should:
# Repair marketplace only (safe to run in current Codex session)
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\.codex\skills\codex-windows-fast-patch\scripts\repatch-codex-windows.ps1" -RegisterMarketplaceOnly
Check if ~/.codex/.agents/plugins/marketplace.json exists and is valid JSON.
Pattern 3: Fast Mode Not Working
User reports: "Fast Mode toggle missing or requests don't include service_tier=priority"
Agent should use external agent or PowerShell session (not current Codex Desktop):
# Run full repatch (will stop and reinstall Codex)
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\.codex\skills\codex-windows-fast-patch\scripts\repatch-codex-windows.ps1"
After patching, verify in Codex Desktop:
Check Fast Mode toggle appears in settings
Capture network request to /v1/responses and confirm service_tier=priority parameter
Pattern 4: Language Reset to English
User reports: "Codex resets to English after restart despite language setting"
codex plugin list
# Should show: chrome@openai-bundled - installed, enabled
Check native messaging host manifest exists at path referenced in registry or manifest file.
Pattern 6: Pre-Upgrade Backup
Before major Codex upgrade:
# Create full backup including dependencies
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\.codex\skills\codex-windows-fast-patch\scripts\manage-codex-backups.ps1" -Action Backup -IncludeDependencyDirs
After upgrade issues, restore:
# List backups to find pre-upgrade timestamp
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\.codex\skills\codex-windows-fast-patch\scripts\manage-codex-backups.ps1" -Action List
# Restore
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\.codex\skills\codex-windows-fast-patch\scripts\manage-codex-backups.ps1" -Action Restore -BackupPath "C:\path\to\codex-backup-20260520-143022.zip"
Verification Examples
Verify Fast Mode Patch
After patching, capture network traffic in Codex Desktop:
// In browser DevTools or network capture// Look for POST to /v1/responses or similar// Request body should contain:
{
"service_tier": "priority",
// ... other params
}
Or reinstall original Codex MSIX from Windows Store.
Issue: "Fast Mode still not working after patch"
Verify patch log shows patched not already-patched (confirms changes were made)
Completely restart Codex Desktop (kill all processes)
If using CPA upstream, ensure CPA override rule forces service_tier=priority for Codex model
Capture network request and verify service_tier=priority in request body
Check Codex subscription status (Fast Mode requires valid subscription)
Issue: "Skill updates fail from GitHub"
Skill auto-updates require network access to https://github.com. If behind firewall or VPN:
# Manually update skill
cd $env:USERPROFILE\.codex\skills\codex-windows-fast-patch
git pull origin main
# Or re-run installation steps from fresh clone
Auto-update failures won't block skill usage; agent will continue with current local version.
CPA Upstream Configuration
If Codex uses CPA as upstream proxy, local service_tier=priority patch alone is insufficient. Configure CPA override rule:
Model: The model name handling Codex requests (e.g., gpt-4-0125-preview)
Parameter: service_tier
Type: String
Value: priority
This ensures upstream processes requests via Fast/Priority path.
When to Use This Skill
Safe for Current Codex Session
Computer Use helper missing or invalid path
Plugin marketplace config corrupted
Marketplace manifest structure broken
Verifying patch status without changes
Run these from within current Codex Desktop session.
Requires External Agent
Fast Mode toggle missing or requests lack service_tier=priority
Plugin install buttons grayed out
Computer Control "Any App" disabled
Browser/Chrome/browser_use disabled by feature gates
Language resets to English after restart
Codex mobile/connection page stuck on login
Goal entry point missing
These require MSIX/ASAR modification. Run from external PowerShell or different agent to avoid current Codex session stopping itself mid-operation.
Real-World Example Workflow
User says: "Use codex-windows-fast-patch skill to check and fix Codex Desktop Fast Mode, locale, Chrome browser_use, plugin marketplace, and Computer Use on this Windows machine."
# Check patch log contains:
# - fast-mode UI patch result: patched
# - fast-mode request patch result: patched
# - locale i18n patch result: patched
# - browser-use gate patch result: patched
# Verify Fast Mode request
# Capture /v1/responses request and confirm service_tier=priority
# Verify browser availability
# Check Codex logs for browser_use_availability_resolved: available=true, reason=local-patched
# Verify Chrome plugin
codex plugin list | Select-String "chrome"
# Expected: chrome@openai-bundled - installed, enabled
# Verify native messaging host
# Check manifest path exists and points to valid chrome-native-host.json
# Smoke test browser control
# Try to read controlled tab title, expect "Example Domain" or similar
If issues persist, check upstream CPA config if applicable.
Note: These scripts are reference implementations and operation templates, not one-size-fits-all solutions. Before execution, agent should read SKILL.md, inspect current machine's Codex installation method, MSIX package paths, ASAR contents, signing tools, plugin directories, and Computer Use file status, then decide whether to execute, modify, or only reference the provided steps.
