A Field Manual for Codex That Actually Mentions the Bugs

What it does This repo publishes a complete OpenAI Codex manual as PDF, EPUB, and single-file HTML in both English and Chinese. It covers all five current interfaces—CLI, Desktop App, Cloud, IDE extension, and Chrome extension—plus the mobile remote companion, with the stated goal of getting a solo builder from installation to shipped product in about a week.

The interesting bit The author, HuaShu, claims never to have written a line of code by hand, yet he shipped an App Store #1 paid app and runs a 300K-follower operation entirely through AI prompting. Instead of breathless hype, the book treats Codex like a table saw: it notes exactly where GPT-5.5 still loses to Claude Opus 4.7, how the 1M context window shrinks to roughly 258K usable tokens, and which Windows settings have reportedly deleted hundreds of gigabytes of user files.

Key highlights

• Surfaces all five Codex forms plus the mobile companion, including the May 2026 Chrome extension and Desktop Automations
• Documents GPT-5.5 benchmarks (SWE-bench Verified 82.6%, Terminal-Bench 2.0 82.7%) while admitting where Claude Opus 4.7 retains the lead
• Offers a dual-tool mental model for choosing between Codex and Claude Code in production
• Flags concrete hazards: Windows Full Access file deletion, three unfixed MultiAgentV2 issues, and the gap between advertised and usable context length
• Written by a daily practitioner who builds with AI, not a traditional developer observing from the sidelines

Caveats

• The 1M-token context window is effectively ~258K usable tokens, a limitation the author surfaces but the tool’s marketing obscures
• Several features described (GPT-5.5 default, mobile companion, Chrome extension) are pinned to May 2026 and may evolve faster than the book’s release cycle
• MultiAgentV2 ships with three outstanding GitHub issues that remain unfixed as of the v2.0.0 release

Verdict Download it if you are shipping with Codex and want a workflow that includes honest escape hatches. Skip it if you need official API docs or a cloneable codebase; this is a prose field manual with attached book files.