docs: refresh README and skill metadata

Author: Loongphy

.agents/skills/codex-upstream-reapply/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: codex-upstream-reapply
-description: "Tag-based upstream sync for a fork/secondary-development repo: by default auto-pick the latest stable rust-vX.Y.Z tag and current branch, create a fresh branch from that tag, then read the old customization branch’s git changes + intent Markdown to re-implement the requirements on the new branch (no merge/rebase of the old branch)."
+description: 'Reapply a fork or secondary-development branch onto the latest stable rust-vX.Y.Z tag by creating a fresh branch from that tag and re-implementing the old branch intent without merge or rebase.'
 ---
 
 # Codex Upstream Reapply

.agents/skills/status-header/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: status-header
-description: Enforce the standard TUI status header layout, icons, colors, and rate-limit summary format when implementing or editing the status header (ratatui Line/Span), and keep equivalent `tui` / `tui_app_server` surfaces aligned.
+description: 'Enforce the standard TUI status header layout, icons, colors, and rate-limit summary format, and keep equivalent tui and tui_app_server surfaces aligned.'
 ---
 
 # Status Header

README.md

@@ -7,15 +7,51 @@ An opinionated Codex CLI. This is strictly a personal hobby project, forked from
 ![TUI](
 https://github.com/user-attachments/assets/127abbc2-cb30-4d6e-8a81-ce707260c045)
 
+> [!IMPORTANT]
+> **DO NOT USE IN PRODUCTION.**
+> To keep upstream sync easy, we do not write test code for what we changed. This project is for experimental use only.
+
+* **DX Focused:** Focus strictly on optimizing developer experience, **without adding new features**.
+* **Upstream Sync:** We sync with the upstream repository regularly.
+
 ## Quick Start
 
-Build from source:
+Choose one of these two ways:
+
+* Install from npm:
+
+```shell
+npm i -g @loongphy/codext
+```
+
+* Build from source:
 
 ```shell
 cd codex-rs
 cargo run --bin codex
 ```
 
+## Features
+
+> Full change log: see [CHANGED.md](./CHANGED.md).
+
+* `Ctrl+Shift+C` in the TUI composer copies the current draft to the system clipboard; `Ctrl+C` keeps its existing behavior, and empty drafts still fall back to the old `Ctrl+C` path.
+* TUI status header with model/effort, cwd, git summary, and rate-limit status.
+* Collaboration mode presets accept per-mode overrides and default to the active `/model` settings. Example:
+
+  ```toml
+  # config.toml
+  [collaboration_modes.plan]
+  model = "gpt-5.4"
+  reasoning_effort = "xhigh"
+
+  [collaboration_modes.code]
+  model = "gpt-5.4"
+  ```
+
+* TUI watches `auth.json` for external login changes and reloads auth automatically, with a warning on account switch. This works well with [codex-auth](https://github.com/Loongphy/codex-auth) when you refresh or switch login state outside the TUI.
+* AGENTS.md and project-doc instructions are refreshed on each new user turn, and Codex shows an explicit warning when a refresh is applied.
+
 ## Project Goals
 
 We will never merge code from the upstream repo; instead, we re-implement our changes on top of the latest upstream code.
@@ -33,43 +69,6 @@ flowchart TD
     G --> H[Force-push to fork main]
 ```
 
-> [!IMPORTANT]
-> **DO NOT USE IN PRODUCTION.**
-> To keep upstream sync easy, we do not write test code for what we changed. This project is for experimental use only.
-
-* **DX Focused:** Focus strictly on optimizing developer experience, **without adding new features**.
-* **Upstream Sync:** We sync with the upstream repository regularly.
-
-## What Changed
-
-* Added `Ctrl+Shift+C` in the TUI composer to copy the current draft to the system clipboard; `Ctrl+C` keeps its existing behavior, and empty drafts still fall back to the old `Ctrl+C` path.
-* On WSL2, TUI draft copy reuses the existing Windows clipboard fallback so copied drafts still land in the Windows system clipboard.
-* Added a TUI status header with model/effort, cwd, git summary, and rate-limit status.
-* Collaboration mode presets now accept per-mode overrides and default to the active `/model` settings.
-* TUI watches `auth.json` for external login changes and reloads auth automatically (with a warning on account switch).
-* AGENTS.md/project-doc instructions are refreshed on each new user turn, and Codex shows an explicit warning when a refresh is applied.
-* Full change log: see [CHANGED.md](./CHANGED.md).
-
-## AGENT Local development check
-
-1. DO NOT update any test codes
-2. After making code changes, verify the CLI still launches:
-
-```shell
-cd ./codex-rs
-cargo run --bin codex
-```
-
-```toml
-# config.toml
-[collaboration_modes.plan]
-model = "gpt-5.4"
-reasoning_effort = "xhigh"
-
-[collaboration_modes.code]
-model = "gpt-5.4"
-```
-
 ## Skills
 
 When syncing to the latest upstream codex version, use `.agents/skills/codex-upstream-reapply` to re-implement our custom requirements on top of the newest code, avoiding merge conflicts from the old branch history.