diff --git a/README.md b/README.md
index 54036c8..cdbb65d 100644
--- a/README.md
+++ b/README.md
@@ -57,6 +57,11 @@ Everything below is **deterministic software around the model** (OpenRouter toda
 | **Runtime graph** | Done | `AgentFactory`, `spawn_agent`, depth/child budgets, async `execute_many` | [`orchestration/`](src/ai_agent/orchestration/) · [`harness/registry.py`](src/ai_agent/harness/registry.py) |
 | **Self-Evolving Engineer** | Done | `evolve` → plan/patch/checks → scoped commit → push → PR (optional `--approve` HITL) | [`features/evolve`](src/ai_agent/features/evolve/) · [`config/agents/engineer.yaml`](config/agents/engineer.yaml) |
 - Evolve artifacts live under `.ai_agent/evolve/<run_id>/`.
+
+### Evolve CLI
+
+Run the engineer workflow with `uv run evolve`: it surveys the repository, plans and applies one scoped change, runs checks, then commits and opens a pull request. Add `--approve` to enable human approval for publishing; each run records its plan and result under `.ai_agent/evolve/<run_id>/`.
+
 | **HarnessBank Gene Bank** | Done (v1) | `(where)×(why)` cells + gated screening stubs; evolver ≠ task agent | [`features/harness_bank`](src/ai_agent/features/harness_bank/) |
 | **Organism worker (Phase 2)** | Done | Goal queue + backlog → `run_evolve` on wake → opt-in `--auto-merge` + CI + STOP | [`features/evolve/organism.py`](src/ai_agent/features/evolve/organism.py) · [`config/evolve_backlog.yaml`](config/evolve_backlog.yaml) |
 | **Ops metrics** | Done (log) | JSONL `OpsEvent`, replay/compare hooks | [`harness/ops_metrics.py`](src/ai_agent/harness/ops_metrics.py) |