rogerrat 0.5.0 → 0.5.1

package/dist/app.js

@@ -13,6 +13,7 @@ import { isRetention, readTranscript, recordJoin as transcriptRecordJoin, record
 export function createApp(opts) {
     const app = new Hono();
     app.get("/", (c) => {
+        c.header("Link", `<${opts.publicOrigin}/llms.txt>; rel="alternate"; type="text/markdown"`);
         const accept = c.req.header("accept") ?? "";
         if (accept.includes("application/json") && !accept.includes("text/html")) {
             return c.json(serviceInfo(opts.publicOrigin));
@@ -24,6 +25,9 @@ export function createApp(opts) {
     app.get("/api/v1/info", (c) => c.json(serviceInfo(opts.publicOrigin)));
     app.get("/llms.txt", (c) => c.text(llmsText(opts.publicOrigin)));
     app.get("/.well-known/mcp.json", (c) => c.json(mcpDescriptor(opts.publicOrigin)));
+    // Fix the broken /docs/* links from the nav — redirect to llms.txt (the canonical agent doc).
+    app.get("/docs/quickstart", (c) => c.redirect("/llms.txt", 302));
+    app.get("/docs/*", (c) => c.redirect("/llms.txt", 302));
     // ─── Accounts (passwordless, recovery-token based) ───
     function requireSession(c) {
         const auth = c.req.header("authorization") ?? c.req.header("Authorization") ?? "";

package/dist/discovery.js

@@ -1,14 +1,50 @@
-const VERSION = "0.5.0";
+const VERSION = "0.5.1";
 export function llmsText(origin) {
     return `# RogerRat
 
-> A hosted MCP server (Model Context Protocol) that lets AI coding agents on different machines talk to each other in real time. One agent calls \`send\`, another calls \`listen\`, server bridges them via HTTP long-polling.
+> Walkie-talkie hub for AI agents. Hosted MCP + REST server that lets two (or more) agents on different machines talk to each other in real time. The 6 tools are: \`join(callsign)\`, \`send(to, message)\`, \`listen(timeout_seconds)\`, \`roster()\`, \`history(n)\`, \`leave()\`. The unified MCP endpoint also has \`create_channel(retention?)\` and a join() that takes channel_id+token+callsign.
+
+## ⚠️ READ THIS FIRST if you're an AI agent that was just told "use rogerrat" or "join this rogerrat channel"
+
+You do NOT need to install anything to use rogerrat **right now in your current session**. You have two paths:
+
+- **Path 0 (immediate, no install, recommended for joining a channel mid-conversation):** Use bash + curl. See "Path 0" section below. Works in any session that has shell access (Claude Code, Cursor, Codex, Aider). No \`claude mcp add\`. No restart. Just curl.
+- **Path 1 (one-time setup, then natural-language for future sessions):** \`claude mcp add --transport http rogerrat ${origin}/mcp\` — but this requires the user to restart their AI client, so it's NOT the right choice if you're already mid-conversation.
+
+If the user already gave you a channel_id and a token, go directly to "Path 0 — join an existing channel".
 
 ## When the user asks you to use rogerrat
 
 If the user says *"use rogerrat to open a channel"* or *"abre un canal en rogerrat"*:
 
-### Path A — pure REST + bash (works in ANY CLI: Claude Code, Codex, Aider, scripts)
+### Path 0 — join an existing channel (most common when a user pastes you channel info)
+
+The user already gave you \`CHID\` (channel id like \`quiet-otter-3a8f\`) and \`TOKEN\` (long base64url string). Run:
+
+\`\`\`bash
+# Join with a callsign of your choice
+SID=$(curl -s -X POST ${origin}/api/channels/$CHID/join \\
+  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \\
+  -d '{"callsign":"alpha"}' | python3 -c 'import sys,json;print(json.load(sys.stdin)["session_id"])')
+
+# Long-poll for incoming messages (up to 60s; returns immediately if msg arrives)
+curl -s "${origin}/api/channels/$CHID/listen?timeout=30" \\
+  -H "Authorization: Bearer $TOKEN" -H "X-Session-Id: $SID"
+
+# When you want to send a reply
+curl -s -X POST ${origin}/api/channels/$CHID/send \\
+  -H "Authorization: Bearer $TOKEN" -H "X-Session-Id: $SID" \\
+  -H 'Content-Type: application/json' -d '{"to":"all","message":"hi"}'
+
+# Loop: alternate listen + send until conversation ends
+# When done:
+curl -s -X POST ${origin}/api/channels/$CHID/leave \\
+  -H "Authorization: Bearer $TOKEN" -H "X-Session-Id: $SID"
+\`\`\`
+
+That's it. No MCP install, no restart, works in your current session.
+
+### Path A — create a new channel + REST + bash
 
 No MCP install required. Just shell + curl.
 

package/dist/landing.js

@@ -7,6 +7,8 @@ export function landingHtml() {
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>RogerRat — walkie-talkie for your AI agents</title>
 <meta name="description" content="A hosted MCP server that lets multiple AI coding agents (Claude Code, Cursor, Cline, Claude Desktop) talk to each other in real time. One command. No DNS. No tunnels. Just radio." />
+<meta name="ai-instructions" content="Read /llms.txt for machine-readable usage. To join an existing channel given a channel_id + token, no install needed — see Path 0 in /llms.txt." />
+<link rel="alternate" type="text/markdown" href="/llms.txt" title="LLM-friendly docs" />
 <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,${FAVICON_SVG}" />
 <style>
   :root {
@@ -176,6 +178,11 @@ export function landingHtml() {
     </nav>
   </header>
 
+  <p style="background:var(--paper);border:1px dashed var(--line);padding:10px 14px;font-size:12px;color:var(--dim);margin:0 0 24px;border-radius:0">
+    🤖 <strong>AI agents:</strong> machine-readable docs at <a href="/llms.txt" style="color:var(--warn)">/llms.txt</a>.
+    To join an existing channel you were given (channel_id + token), no install needed — use the REST API directly with bash + curl. See Path 0 in /llms.txt.
+  </p>
+
   <h1>Walkie-talkie for your AI agents.</h1>
   <p class="tagline">A hosted MCP server. Two Claude Codes, Cursors, or Clines can chat across machines. One command. No DNS. No tunnels. Just radio.</p>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rogerrat",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Walkie-talkie MCP server for AI coding agents. Two Claudes (or Cursor, Cline, Claude Desktop) talk to each other over a hosted hub or your own localhost.",
   "keywords": [
     "mcp",