docs: make install path obvious

Author: Dmatut7

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.3 — 2026-06-05
+
+- Moved the install command into the README first screen so GitHub visitors see it immediately.
+- Rebuilt the demo GIF and storyboard SVG so the first frame shows `npm install -g codex-flow` and no terminal lines are clipped.
+
 ## 0.2.2 — 2026-06-05
 
 - Published `codex-flow` on npm and made npm install the primary public path.

README.md

@@ -9,49 +9,46 @@
 
 Turn one natural-language request in Codex App or Codex CLI into **parallel, resumable, journaled Codex sub-agents**.
 
-Instead of asking Codex to do one long linear pass, say “use a dynamic workflow” and let Codex split the task, run branches in parallel, replay completed work after interruption, and summarize the journaled result.
+## Install in 30 seconds
 
-Built for maintainers and power users who do repeated multi-file work:
+```bash
+npm install -g codex-flow
+codex-flow install-codex
+codex-flow doctor
+# restart Codex App or Codex CLI
+```
 
-- **Bug investigations** — one hypothesis or file group per Codex sub-agent.
-- **PR / code review** — fan out review passes, then merge findings.
-- **Issue triage** — classify, reproduce, and propose next actions in parallel.
-- **Release smoke checks** — run repeatable checks with journaled evidence.
+Then open **any** project in Codex and say:
 
-If this is useful, star the repo so more Codex users can find it: [Dmatut7/codex-flow](https://github.com/Dmatut7/codex-flow).
+> 用动态工作流帮我排查登录失败的问题
+>
+> use a dynamic workflow to investigate this bug in parallel
+
+GitHub fallback if npm is unavailable: `npm install -g github:Dmatut7/codex-flow`.
+`dongt` remains as a compatibility alias, but the public package and docs use `codex-flow`.
 
 ## What it feels like
 
 ![codex-flow animated demo](assets/codex-flow-demo.gif)
 
 The important difference is not another config file. It is the loop:
 
-1. say a normal sentence in Codex,
-2. Codex generates a temporary workflow,
-3. `codex-flow` runs the branches,
-4. the journal makes interruption and rerun cheap.
+1. install once,
+2. say a normal sentence in Codex,
+3. Codex generates a temporary workflow,
+4. `codex-flow` runs the branches in parallel,
+5. the journal makes interruption and rerun cheap.
 
 Prefer a static version? See the [storyboard SVG](assets/codex-flow-demo.svg).
 
-## 30-second start
-
-```bash
-npm install -g codex-flow                 # installs the `codex-flow` CLI
-codex-flow doctor                       # checks local install + fake backend
-codex-flow try                          # creates + runs a starter workflow without network
-codex-flow install-codex                # installs the "dynamic-workflow" skill into Codex
-codex-flow doctor                       # confirms the Codex skill is installed
-# restart Codex
-```
+## Why maintainers use it
 
-GitHub fallback if npm is unavailable: `npm install -g github:Dmatut7/codex-flow`.
-`dongt` remains as a compatibility alias, but the public package and docs use `codex-flow`.
-
-Then, in **any** project, just tell Codex:
+Built for maintainers and power users who do repeated multi-file work:
 
-> 用动态工作流帮我排查登录失败的问题
->
-> use a dynamic workflow to investigate this bug across these files, in parallel
+- **Bug investigations** — one hypothesis or file group per Codex sub-agent.
+- **PR / code review** — fan out review passes, then merge findings.
+- **Issue triage** — classify, reproduce, and propose next actions in parallel.
+- **Release smoke checks** — run repeatable checks with journaled evidence.
 
 Codex (via the installed skill) will:
 
@@ -64,6 +61,8 @@ It uses **your Codex / ChatGPT membership login** — no OpenAI API key needed.
 
 If the run is interrupted (Ctrl-C, crash, budget), running it again **resumes**: finished work replays instantly, only unfinished nodes call Codex again.
 
+If this is useful, star the repo so more Codex users can find it: [Dmatut7/codex-flow](https://github.com/Dmatut7/codex-flow).
+
 See [how to use it in Codex App / CLI](docs/CODEX_APP_CLI.md), the [FAQ](docs/FAQ.md), the [prompt gallery](docs/PROMPTS.md) for copy-paste Codex prompts, and the [maintainer workflow gallery](examples/README.md) for import-free runnable bug investigation, PR review, issue triage, and release smoke workflows. See [docs/POSITIONING.md](docs/POSITIONING.md) for what `codex-flow` is / is not, [ROADMAP.md](ROADMAP.md) for public next steps, and [docs/LAUNCH_PLAYBOOK.md](docs/LAUNCH_PLAYBOOK.md) for sharing / launch copy.
 
 ## Why this is more than "an engine"

assets/codex-flow-demo.gif

@@ -14,7 +14,7 @@ OpenAI says the program is for maintainers of active public OSS projects with me
 ## Current readiness
 
 - Public GitHub repository.
-- Public release: https://github.com/Dmatut7/codex-flow/releases/tag/v0.2.2
+- Public release: https://github.com/Dmatut7/codex-flow/releases/tag/v0.2.3
 - MIT license.
 - Clear README with install and usage path.
 - CLI install path: `npm install -g codex-flow`. GitHub fallback: `npm install -g github:Dmatut7/codex-flow`.

assets/codex-flow-demo.svg

@@ -15,7 +15,7 @@ import { aggregateKeys, makeScope, type EngineRuntime, type Scope } from "./runt
 import { createAdapters, resolveBackend as resolveBackendFromRegistry } from "../adapters/registry.ts";
 import type { AgentAdapter, NormalizedAgentOpts, NormalizedSchema } from "../adapters/types.ts";
 
-const DEFAULT_ENGINE_VERSION = "0.2.2";
+const DEFAULT_ENGINE_VERSION = "0.2.3";
 
 class WorkflowEngine implements Engine, EngineRuntime {
   readonly config: Required<Pick<EngineConfig, "defaultBackend" | "autoRoute" | "seed" | "estimatedTokensPerCall" | "engineVersion">> & EngineConfig;

docs/CODEX_FOR_OSS_APPLICATION.md

@@ -1,6 +1,6 @@
 {
   "name": "codex-flow",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Dynamic workflow orchestration for Codex — split complex tasks into parallel, resumable, journaled Codex sub-agents.",
   "type": "module",
   "license": "MIT",

engine/index.ts

@@ -55,7 +55,7 @@ describe("dynamic workflow engine", () => {
     }).run(async ({ agent }) => agent("version", { backend: "fake" }));
 
     const [manifest] = await readJsonl(journalPath);
-    assert.equal(manifest.engineVersion, "0.2.2");
+    assert.equal(manifest.engineVersion, "0.2.3");
     await rm(dir, { recursive: true, force: true });
   });