Persistent background session with multi-image support

Author: benvinegar

pi/README.md

@@ -4,10 +4,12 @@
 
 ## What it does
 
-Registers a `glance` **tool** and a `/glance` **command**:
+Maintains a **persistent background session** on glance.sh. Paste an image anytime — the agent receives it instantly.
 
-- **Tool** — the LLM calls it when it needs to see something visual (your screen, a UI, an error dialog). The agent creates a session, you paste a screenshot in your browser, the agent receives the image URL.
-- **Command** — you type `/glance` in the pi prompt to proactively share a screenshot with the agent.
+- **Background listener** — starts when pi launches, reconnects automatically, refreshes sessions before they expire.
+- **`glance` tool** — the LLM calls it when it needs to see something visual. Surfaces the session URL and waits for the next paste.
+- **`/glance` command** — type it to see the current session URL.
+- **Multiple images** — paste as many images as you want. Each one is injected into the conversation as `Screenshot: <url>`.
 
 ## Install
 
@@ -21,24 +23,32 @@ ln -s "$(pwd)/glance.ts" ~/.pi/extensions/glance.ts
 cp glance.ts ~/.pi/extensions/glance.ts
 ```
 
-Restart pi. The `glance` tool and `/glance` command are now available.
+Restart pi. The background session starts automatically.
 
 ## How it works
 
 ```
-agent ──POST /api/session──▶ { id, url }
-agent ──GET  /api/session/<id>/events──▶ SSE (waiting…)
-user  ──opens /s/<id>, pastes image──▶ agent receives URL
-```
+pi starts
+  └─▶ create session on glance.sh
+  └─▶ connect SSE (background, auto-reconnect)
 
-1. Creates a live session on glance.sh.
-2. Shows you the session URL (status bar + notification).
-3. Connects via SSE and waits up to ~5 minutes.
-4. When you paste an image, the URL is returned to the LLM.
+user pastes image at /s/<id>
+  └─▶ SSE emits "image" event
+  └─▶ extension injects "Screenshot: <url>" into conversation
 
-No API keys required — sessions are anonymous and ephemeral (10-minute TTL).
+session expires (~10 min)
+  └─▶ extension creates new session, reconnects
+```
+
+The `glance` tool reuses the existing background session — it just surfaces the URL and waits for the next image rather than creating a new session each time.
 
 ## Requirements
 
 - [pi](https://github.com/mariozechner/pi) coding agent
 - Node.js with global `fetch` (Node 18+)
+
+## Configuration
+
+No API keys required — sessions are anonymous and ephemeral (10-minute TTL).
+
+The extension connects to `https://glance.sh` by default. The SSE connection is held for ~5 minutes per cycle, with automatic reconnection.