Skip to content

Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.

README release refresh: banner, numbers-first lead, combined demo GIF (#562)

Swati Ahujaaaebd82ec839
diff --git a/.github/assets/banner.png b/.github/assets/banner.png
index fa9045b06..214f349f6 100644
Binary files a/.github/assets/banner.png and b/.github/assets/banner.png differ
diff --git a/.github/assets/demo.gif b/.github/assets/demo.gif
index 0ba6dd8c3..dbf2caead 100644
Binary files a/.github/assets/demo.gif and b/.github/assets/demo.gif differ
diff --git a/.github/assets/savings.png b/.github/assets/savings.png
index dcb7ccfae..702bea591 100644
Binary files a/.github/assets/savings.png and b/.github/assets/savings.png differ
diff --git a/.github/assets/webui.gif b/.github/assets/webui.gif
index fece7ce63..33a371445 100644
Binary files a/.github/assets/webui.gif and b/.github/assets/webui.gif differ
diff --git a/README.md b/README.md
index 60a50a130..9afa2675d 100644
--- a/README.md
+++ b/README.md
@@ -41,7 +41,15 @@
---
-<img src=".github/assets/demo.gif" alt="repowise demo — repowise init → Claude Code querying via MCP tools" width="100%" />
+<p align="center">
+ <strong>up to −96% context tokens</strong> &nbsp;·&nbsp; <strong>−70% agent tool calls</strong> &nbsp;·&nbsp; <strong>answer quality at parity</strong><br/>
+ <strong>60–90% fewer tokens</strong> on noisy command output &nbsp;·&nbsp; errors-first, fully reversible<br/>
+ <strong>code health that predicts real bugs</strong> &nbsp;·&nbsp; <strong>ROC AUC 0.74</strong> &nbsp;·&nbsp; <strong>2.3×</strong> the commercial market leader under a fixed review budget
+</p>
+
+<p align="center"><sub>Measured, reproducible, on public codebases — <a href="#benchmarks">see the benchmarks ↓</a></sub></p>
+
+<img src=".github/assets/demo.gif" alt="repowise demo — Claude Code querying the codebase through repowise's MCP tools, then a tour of the local dashboard" width="100%" />
---
@@ -245,7 +253,7 @@ Full report: **[health-defect/BENCHMARK_REPORT.md →](https://github.com/repowi
`repowise serve` starts a full web UI alongside the MCP server — no separate
setup.
-<img src=".github/assets/webui.gif" alt="repowise web UI" width="100%" />
+<img src=".github/assets/webui.gif" alt="repowise local dashboard — Overview, Knowledge Graph, Code Health map, Commits, Chat, and By the Numbers" width="100%" />
Highlights: **Chat** (natural-language Q&A) · **Docs** (wiki with Mermaid +
graph sidebar) · **Graph** (interactive, 2,000+ nodes, community coloring, path
@@ -457,7 +465,7 @@ pricing: **[docs/COMMERCIAL.md](docs/COMMERCIAL.md)** · [Get in touch →](http
## Privacy
-- **Self-hosted:** your code never leaves your infrastructure. No telemetry. No analytics.
+- **Self-hosted:** your code never leaves your infrastructure — no code, file paths, or repo names are ever sent. The CLI does report **anonymous, opt-out** usage telemetry (command names + coarse environment only) to help us prioritize; turn it off with `repowise telemetry disable`, `DO_NOT_TRACK=1`, or by running fully offline. [What's collected →](docs/TELEMETRY.md)
- **BYOK:** bring your own Anthropic / OpenAI key. We never see your LLM calls. Zero data retention via Anthropic's API policy.
- **What's stored:** the NetworkX graph, LanceDB embeddings (non-reversible vectors), generated wiki pages, git metadata. Raw source is processed transiently and never persisted.
- **Fully offline:** Ollama + a local embedding model = zero external API calls.