diff --git a/README.md b/README.md
index d086c06..0941a51 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,7 @@ npx -y @sylphx/iris
```
Starts the MCP server on stdio (agents / Codex / Claude Desktop).
+**Live:** `@sylphx/iris@0.2.1` · brand-sole `serverInfo.name=iris` · portable linux natives.
### Image evidence for agents
@@ -18,14 +19,26 @@ Canonical package: **`@sylphx/iris`** · bin **`iris`**
**Iris** — **Rust-first** local image facts (`@sylphx/iris`) local image facts, not default VLM guesses. `sharp`/`exifr` are optional, not required for MCP.
-
+
### Your agent looked at the image. **Did it see the truth?**
-Evidence-first image reading for AI agents. One call turns any local image into an
-**Agent Media Twin** — dimensions, metadata, optional OCR with bounding boxes, and
-trust warnings you can cite without asking a vision LLM to guess.
+**Iris** is local-first **image evidence** for agents — dimensions, metadata, regions, optional OCR with boxes — **without** a default vision-LLM hallucination loop.
+
+```bash
+npx -y @sylphx/iris
+```
+
+| | Vision model guess | **Iris** |
+| --- | --- | --- |
+| Reproducible facts | ❌ varies by model | ✅ deterministic media twin |
+| Bounding boxes / regions | rare | first-class evidence |
+| Cloud API required | often | **no** |
+| Setup | keys + SDKs | **zero-config npx** |
+| Brand | mixed | `@sylphx/iris` · bin `iris` · **0.2.1** |
+
+**Rust-first** MCP runtime. Missing native → fail closed.
[](https://www.npmjs.com/package/@sylphx/iris)
[](https://opensource.org/licenses/MIT)
@@ -104,7 +117,14 @@ an image, not a creative caption.**
## See it work
-### Install (30 seconds)
+### Why Iris wins for agents
+
+1. **Zero-config** — `npx -y @sylphx/iris` starts MCP on stdio.
+2. **Facts over captions** — structure agents can cite, not free-text “I see a chart”.
+3. **Local-first** — files never leave the machine by default.
+4. **Family** — pair with Citra (PDF), Cue (video), Locus (code).
+
+## Install (30 seconds)
```bash
npm install -g @sylphx/iris
diff --git a/docs/COMPETITIVE.md b/docs/COMPETITIVE.md
index c408a24..6174514 100644
--- a/docs/COMPETITIVE.md
+++ b/docs/COMPETITIVE.md
@@ -30,3 +30,11 @@ Local decode/OCR path; no generative vision model required.
See docs/specs/agent-*-read-contract.md for competitive synthesis and product decisions.
+
+## Zero-config CTA
+
+```bash
+npx -y @sylphx/iris
+```
+
+Live **@sylphx/iris@0.2.1**. Bare MCP stdio for agents.
diff --git a/docs/POSITIONING.md b/docs/POSITIONING.md
index 34ade1a..201d86d 100644
--- a/docs/POSITIONING.md
+++ b/docs/POSITIONING.md
@@ -42,3 +42,9 @@ See [IPPB.md](./IPPB.md).
Optional open-vocab objects + caption via local Florence/DINO/SAM adapters or Ollama,
behind `include_semantics`. Default remains L0/L1 facts only (zero-config).
+
+## Zero-config
+
+```bash
+npx -y @sylphx/iris
+```
diff --git a/docs/PUBLISH.md b/docs/PUBLISH.md
index e5841f8..dd883a7 100644
--- a/docs/PUBLISH.md
+++ b/docs/PUBLISH.md
@@ -9,3 +9,11 @@
```bash
npm i -g @sylphx/iris
```
+
+## Zero-config CTA
+
+```bash
+npx -y @sylphx/iris
+```
+
+Live **@sylphx/iris@0.2.1**. Bare MCP stdio for agents.