From ec4141f541479b38c882232f23f9e6fbc5961143 Mon Sep 17 00:00:00 2001
From: Fsocietyhhh <1211904451@qq.com>
Date: Tue, 28 Apr 2026 00:59:56 -0700
Subject: [PATCH] docs(readme): mention the VS Code extension under Quick start
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The CLI install is the only entry point currently advertised on the
front page of the README, but the same agent has shipped as a VS Code
extension for a while now. New users coming from the GitHub page have
no signal that there's a GUI option.

This adds a short subsection right after the CLI Quick start with:
- Marketplace link
- Three-line install path (Extensions panel → search Franklin → click)
- A note that CLI and extension share ~/.blockrun/ state, so a wallet
  funded for one works for the other and session history carries over

Scope deliberately narrow — one block, no rearrangement of existing
content, no new badges, no separate top-level section. The pitch /
YOPO / Smart Router etc. stay intact.
---
 README.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/README.md b/README.md
index 4515d00c..473eb945 100644
--- a/README.md
+++ b/README.md
@@ -69,6 +69,18 @@ franklin balance           # show address + USDC balance
 
 That's it. Zero signup, zero credit card, zero phone verification. Send **$5 of USDC** to the wallet and you've unlocked every frontier model and every paid tool in the BlockRun gateway.
 
+### Prefer a GUI? Try Franklin for VS Code
+
+The same agent ships as a [VS Code extension](https://marketplace.visualstudio.com/items?itemName=blockrun.franklin-vscode) — chat panel, model picker, wallet balance, image / video generation, inline diff cards — all driven by the wallet you already funded for the CLI.
+
+```
+VS Code → Extensions  (Cmd+Shift+X / Ctrl+Shift+X)
+        → search "Franklin" → Install
+        → click the Franklin icon in the Activity Bar
+```
+
+Free models work immediately. Paid models, image gen, and video gen activate the moment your wallet has USDC. The CLI and the extension share the same `~/.blockrun/` config and session history, so jumping between terminal and VS Code is seamless.
+
 ---
 
 ## YOPO