@viberaven/cli 1.3.5 → 1.4.0

package/README.md

@@ -4,7 +4,13 @@
 [![npm downloads](https://img.shields.io/npm/dw/@viberaven/cli)](https://www.npmjs.com/package/@viberaven/cli)
 [![license](https://img.shields.io/npm/l/@viberaven/cli)](https://www.npmjs.com/package/@viberaven/cli)
 
-VibeRaven is the local Studio cockpit for AI-built apps. It gives Codex, Claude Code, Gemini CLI, Cursor, and other coding agents a clean production workspace for chat, provider context, MCP-assisted setup, release/version review, diffs, and approval-controlled repo work.
+<p align="center">
+  <img src="assets/report/assets/viberaven-hero.png" alt="VibeRaven — the raven fanning its hand of provider cards" width="460" />
+</p>
+
+VibeRaven is **the Card Table** — a local Studio where your AI-built app is laid out in front of you. Every provider (Supabase, Vercel, Stripe, ...) is a graded trading card in your hand: play a card and its production checks run instantly in chat; a **RAVEN GRADE 10** means that territory is production-ready. Versions are a pile you can pull from, your whole architecture is a region map of cards, and Codex, Claude Code, or Gemini CLI does the actual work — with you controlling how much it's allowed to touch.
+
+![The VibeRaven Card Table](assets/report/assets/viberaven-table.png)
 
 ## Start the Studio
 
@@ -12,13 +18,13 @@ VibeRaven is the local Studio cockpit for AI-built apps. It gives Codex, Claude
 npx -y viberaven
 ```
 
-That command opens the local Studio UI for:
+That command opens the table:
 
-- agentic chat with connected CLIs;
-- draggable provider and release context;
-- provider MCP visibility;
-- architecture map, terminal, and diff views;
-- approval modes for ask, approve, and full-access work.
+- **Your hand** — providers as foil cards; click or drop one on the table and its launch checks run in chat, graded 1-10 from repo evidence.
+- **The version pile** — pull a release card to see what changed (real git compare + changelog), view the diff, or ask the agent to explain it.
+- **The region map** — your app as territory: pages, modules, and provider cards connected by routes, every card movable.
+- **Agentic chat** — missions run through your connected CLI, with `ask` / `approve` / `full` access modes and inline approve for risky work.
+- Provider MCP visibility, terminal, and diff views included.
 
 The unscoped `viberaven` package is a small shim that launches this CLI package.