Codex 0.148.0: support + improvements

.codex-version

@@ -1 +1 @@
-0.147.0
+0.148.0

README.md

@@ -25,7 +25,7 @@
     <img src="https://img.shields.io/badge/Cursor-3.16.17-000000" alt="Cursor" />
   </a>
   <a href="docs/engineering/build-and-release/platform-targets.json">
-    <img src="https://img.shields.io/badge/Codex-0.146.0-412991" alt="Codex" />
+    <img src="https://img.shields.io/badge/Codex-0.148.0-412991" alt="Codex" />
   </a>
   <a href="docs/engineering/build-and-release/platform-targets.json">
     <img src="https://img.shields.io/badge/OpenCode-1.18.11-fab283" alt="OpenCode" />

docs/engineering/build-and-release/platform-targets.json

@@ -1,6 +1,6 @@
 {
   "schema_version": 2,
-  "last_reviewed": "2026-08-17",
+  "last_reviewed": "2026-08-19",
   "reviewed_by_skill": "tamirs-superpowers@2.0.0",
   "supported_targets": [
     "claude_code",
@@ -115,9 +115,9 @@
       "supported_min": "0.40.0",
       "supported_min_source": "earliest release this repo has claimed AGENTS.md + .codex-plugin manifest support for",
       "validated_against": "0.146.0",
-      "latest_known": "0.147.0",
-      "verified_on": "2026-08-09",
-      "verification_method": "0.146.0 was exercised on the maintainer machine; 0.147.0 support was reviewed against the official OpenAI release delta and is tracked by .codex-version pending the next direct CLI validation",
+      "latest_known": "0.148.0",
+      "verified_on": "2026-08-19",
+      "verification_method": "0.146.0 was exercised on the maintainer machine; 0.148.0 support was reviewed against the official OpenAI release delta and is tracked by .codex-version pending the next direct CLI validation",
       "install_doc": "docs/user/install/codex.md",
       "doc_urls": [
         "https://developers.openai.com/codex/guides/agents-md",
@@ -127,7 +127,8 @@
         "codex-plugin-manifest",
         "agents-md",
         "hooks-field",
-        "portable-agent-plugins-0.147.0"
+        "portable-agent-plugins-0.147.0",
+        "codex-0.148.0-hook-capability-review"
       ],
       "capabilities": [
         "skills",

docs/user/install/codex.md

@@ -3,7 +3,7 @@
 | | |
 |---|---|
 | **Validated against** | Codex CLI **0.146.0** |
-| **Latest supported** | **0.147.0** |
+| **Latest supported** | **0.148.0** |
 | **Minimum supported** | **0.40.0** |
 | **Plugin manifest** | `.codex-plugin/plugin.json` |
 | **Marketplace manifest** | `.agents/plugins/marketplace.json` |
@@ -15,7 +15,7 @@ Check your version:
 codex --version
 ```
 
-Codex 0.147.0 expands portable Agent Plugin/catalog discovery. This repo already ships the native Codex plugin manifest, marketplace manifest, hooks, skills, MCP stubs, and `AGENTS.md`, so no manifest migration is required. Support for 0.147.0 was reviewed against the official release delta; the last direct maintainer-machine CLI validation remains 0.146.0.
+Codex 0.148.0 keeps the portable Agent Plugin/catalog model introduced in 0.147.0 and adds asynchronous command hooks plus MCP-tool hook actions. This repo already ships the native Codex plugin manifest, marketplace manifest, hooks, skills, MCP stubs, and `AGENTS.md`, so no manifest migration is required. The existing `hooks/hooks.json` is intentionally shared across hosts and remains unchanged: adopting Codex-specific async/MCP hook fields there would change another target's behavior, so that is deferred until the shared hook bundle can express host-specific semantics safely. Support for 0.148.0 was reviewed against the official release delta; the last direct maintainer-machine CLI validation remains 0.146.0.
 
 > **Where the marketplace manifest lives.** Codex resolves marketplaces from `.agents/plugins/marketplace.json` at the repo root — *not* from `.codex-plugin/marketplace.json`. Point `codex plugin marketplace add` at a root without that file and it fails with `marketplace root does not contain a supported manifest`. This repo ships one, which is what makes standalone install work.