@chatpanel/bridge 0.1.0 → 0.1.2

package/README.md

@@ -7,22 +7,47 @@ so this bridges the gap.
 - **Claude Code** — embedded via `@anthropic-ai/claude-agent-sdk`, using your
   existing Claude Code login (or `ANTHROPIC_API_KEY`).
 - **Codex** — driven via the `codex exec` CLI, using your `codex login`.
+- **Gemini CLI** — driven via the `gemini -p` CLI, using your `gemini` login.
+
+Bring whichever agent you already have installed — the extension auto-detects
+the ones the bridge reports as available.
 
 ## Run it
 
+**No clone, no install** — `npx` fetches the package (and its one dependency) and
+starts the server:
+
+```bash
+npx @chatpanel/bridge        # → http://127.0.0.1:4319
+```
+
+…then leave it running and open the ChatPanel side panel. That's the whole setup.
+
+Prefer a persistent command? Install it globally:
+
 ```bash
-cd bridge
-npm install      # installs the Claude Agent SDK (Codex just needs the CLI)
-npm start        # → http://127.0.0.1:4319
+npm i -g @chatpanel/bridge
+chatpanel-bridge             # → http://127.0.0.1:4319
 ```
 
-Prerequisites:
+Prerequisites (the agents you want to use must already be set up):
 
 - **Claude Code**: be signed in (`claude`) or set `ANTHROPIC_API_KEY`.
 - **Codex**: `codex` on your `PATH` and `codex login` done.
 
 The extension polls `/health` and shows each agent as available/unavailable.
 
+## Develop (from source)
+
+Only if you're hacking on the bridge itself:
+
+```bash
+git clone https://github.com/chatpanel/chatpanel-bridge
+cd chatpanel-bridge
+npm install
+npm start                    # → http://127.0.0.1:4319
+```
+
 ## API
 
 | Method | Path | Purpose |

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@chatpanel/bridge",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
-  "description": "Local bridge that exposes Claude Code (Agent SDK) and Codex (CLI) to the ChatPanel Chrome extension over a localhost SSE endpoint.",
-  "keywords": ["chatpanel", "claude-code", "codex", "chrome-extension", "ai-agents", "bridge"],
+  "description": "Local bridge that exposes the AI coding agents installed on your machine — Claude Code (Agent SDK), Codex (CLI), and Gemini CLI — to the ChatPanel Chrome extension over a localhost SSE endpoint. Bring your own agent.",
+  "keywords": ["chatpanel", "claude-code", "codex", "gemini-cli", "chrome-extension", "ai-agents", "bridge"],
   "homepage": "https://chatpanel.net",
   "repository": { "type": "git", "url": "git+https://github.com/chatpanel/chatpanel-bridge.git" },
   "license": "MIT",

package/src/engines/claude.js

@@ -10,14 +10,6 @@
 import path from 'node:path';
 import os from 'node:os';
 
-// Always-on guidance so the coding agent behaves like a browser assistant by
-// default: prefer the page context the extension attaches over scanning files.
-const BASE_GUIDANCE =
-  'You are ChatPanel, an AI assistant living in a browser side panel. When the ' +
-  "user's message includes <context> blocks (extracted web pages or selections), " +
-  'answer primarily from those. Only read or modify local files when the user ' +
-  'explicitly asks about code or a project.';
-
 let sdkPromise = null;
 function loadSdk() {
   if (!sdkPromise) sdkPromise = import('@anthropic-ai/claude-agent-sdk').catch(() => null);
@@ -86,11 +78,12 @@ export async function chat({ messages, system, options }, emit) {
       // servers and CLAUDE.md apply. Turn the agent's "Use my local skills &
       // config" off to run clean.
       settingSources: options.useLocalConfig === false ? [] : ['user', 'project'],
-      systemPrompt: {
-        type: 'preset',
-        preset: 'claude_code',
-        append: [BASE_GUIDANCE, system].filter(Boolean).join('\n\n'),
-      },
+      // Native Claude Code system prompt. Only append the user's OWN system
+      // prompt if they set one — no ChatPanel persona is injected, so the agent
+      // is exactly as capable as it is in the terminal.
+      systemPrompt: system
+        ? { type: 'preset', preset: 'claude_code', append: system }
+        : { type: 'preset', preset: 'claude_code' },
       ...(options.model ? { model: options.model } : {}),
       ...(process.env.CHATPANEL_MAX_TURNS ? { maxTurns: Number(process.env.CHATPANEL_MAX_TURNS) } : {}),
     },
@@ -99,9 +92,14 @@ export async function chat({ messages, system, options }, emit) {
   for await (const message of iterator) {
     if (message.type === 'stream_event') {
       const ev = message.event;
-      if (ev?.type === 'content_block_delta' && ev.delta?.type === 'text_delta') {
-        streamedAny = true;
-        emit({ type: 'delta', text: ev.delta.text });
+      if (ev?.type === 'content_block_delta') {
+        if (ev.delta?.type === 'text_delta') {
+          streamedAny = true;
+          emit({ type: 'delta', text: ev.delta.text });
+        } else if (ev.delta?.type === 'thinking_delta') {
+          // Extended thinking — stream the reasoning text to the panel.
+          emit({ type: 'reasoning', text: ev.delta.thinking || '' });
+        }
       }
     } else if (message.type === 'assistant') {
       for (const block of message.message.content) {

package/src/engines/codex.js

@@ -58,14 +58,6 @@ function ensureIsolatedHome() {
   return ISO_HOME;
 }
 
-const BASE_GUIDANCE =
-  'You are ChatPanel, an AI assistant in a browser side panel. Answer the ' +
-  "user's question using the <context> blocks provided (web pages or selections). " +
-  'Do NOT search the filesystem or read local files for general questions — ' +
-  'everything you need is in the prompt. Only inspect files if the user explicitly ' +
-  'asks about local code or a project. When asked for a table, return GitHub-' +
-  'flavored Markdown.';
-
 let installed = null;
 export async function available() {
   if (installed === null) {
@@ -82,7 +74,7 @@ export async function available() {
 }
 
 function buildPrompt(messages, system) {
-  let p = `${[BASE_GUIDANCE, system].filter(Boolean).join('\n\n')}\n\n`;
+  let p = system ? `${system}\n\n` : '';
   const history = messages.slice(0, -1);
   const last = messages[messages.length - 1];
   if (history.length) {

package/src/engines/gemini.js

@@ -0,0 +1,102 @@
+// Gemini engine — drives the Gemini CLI (`gemini -p`) using your local login.
+//
+// Like the Codex engine, this shells out to the installed `gemini` binary in
+// non-interactive mode: `gemini -p "<prompt>"` runs once, prints the answer to
+// stdout, and exits. We run in an empty scratch dir for general chat so Gemini
+// never crawls the bridge's own files; set a working dir on the agent to point
+// it at a real project.
+//
+// Install: `npm i -g @google/gemini-cli`, then run `gemini` once to sign in.
+
+import { spawn, spawnSync } from 'node:child_process';
+import { mkdirSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+const TIMEOUT_MS = Number(process.env.CHATPANEL_GEMINI_TIMEOUT_MS) || 180_000;
+const SCRATCH = path.join(os.tmpdir(), 'chatpanel-gemini-scratch');
+
+let installed = null;
+export async function available() {
+  if (installed === null) {
+    try {
+      const r = spawnSync('gemini', ['--version'], { stdio: 'ignore', timeout: 5000 });
+      installed = r.status === 0 || (r.status === null && r.error === undefined);
+    } catch {
+      installed = false;
+    }
+  }
+  return installed
+    ? { ok: true }
+    : { ok: false, reason: 'gemini not found on PATH. Install @google/gemini-cli, then run `gemini` once to sign in.' };
+}
+
+function buildPrompt(messages, system) {
+  let p = system ? `${system}\n\n` : '';
+  const history = messages.slice(0, -1);
+  const last = messages[messages.length - 1];
+  if (history.length) {
+    p += 'Conversation so far:\n';
+    for (const m of history) p += `${m.role === 'user' ? 'User' : 'Assistant'}: ${m.content}\n\n`;
+    p += '---\n\n';
+  }
+  p += last ? last.content : '';
+  return p;
+}
+
+export async function chat({ messages, system, options }, emit) {
+  try {
+    mkdirSync(SCRATCH, { recursive: true });
+  } catch {
+    /* best effort */
+  }
+  const cwd = options.workingDir ? path.resolve(options.workingDir) : SCRATCH;
+
+  // `-p` is non-interactive (no TTY prompts). `-m` picks the model. `-y` (yolo)
+  // auto-approves tool calls when the user opted into bypassPermissions — without
+  // it Gemini would block on an approval it can't show in a headless run.
+  const args = ['-p', buildPrompt(messages, system)];
+  if (options.model) args.push('-m', options.model);
+  if (options.permissionMode === 'bypassPermissions') args.push('-y');
+
+  await new Promise((resolve, reject) => {
+    let child;
+    try {
+      // stdin ignored: the prompt is passed via -p, and no TTY means no
+      // interactive "trust this folder?" dialog can block us.
+      child = spawn('gemini', args, { cwd, stdio: ['ignore', 'pipe', 'pipe'], env: { ...process.env } });
+    } catch (e) {
+      return reject(new Error(`Failed to start gemini: ${e.message}`));
+    }
+
+    let out = '';
+    let err = '';
+    let streamed = false;
+    const timer = setTimeout(() => {
+      child.kill('SIGKILL');
+      reject(new Error(`Gemini timed out after ${Math.round(TIMEOUT_MS / 1000)}s.`));
+    }, TIMEOUT_MS);
+
+    child.stdout.on('data', (d) => {
+      const s = d.toString();
+      out += s;
+      streamed = true;
+      emit({ type: 'delta', text: s });
+    });
+    child.stderr.on('data', (d) => (err += d.toString()));
+    child.on('error', (e) => {
+      clearTimeout(timer);
+      reject(new Error(`Failed to start gemini: ${e.message}`));
+    });
+    child.on('close', (code) => {
+      clearTimeout(timer);
+      if (code === 0) {
+        if (!streamed) emit({ type: 'delta', text: out.trim() || '(no output)' });
+        emit({ type: 'done', text: '' });
+        resolve();
+      } else {
+        reject(new Error(`Gemini exited ${code}: ${err.trim() || out.trim() || 'failed'}`));
+      }
+    });
+  });
+}

package/src/server.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 // ChatPanel Bridge — a tiny localhost server that exposes the coding agents
-// running on this machine (Claude Code via the Agent SDK, Codex via its CLI) to
-// the ChatPanel Chrome extension. Zero runtime dependencies beyond the optional
-// Claude Agent SDK.
+// running on this machine (Claude Code via the Agent SDK, Codex and Gemini via
+// their CLIs) to the ChatPanel Chrome extension. Zero runtime dependencies
+// beyond the optional Claude Agent SDK.
 //
 //   GET  /health  → { ok, version, agents: [{id,label,available,reason}] }
 //   POST /chat    → Server-Sent Events stream of { type, ... }:
@@ -17,6 +17,7 @@
 import { createServer } from 'node:http';
 import * as claude from './engines/claude.js';
 import * as codex from './engines/codex.js';
+import * as gemini from './engines/gemini.js';
 
 const VERSION = '0.1.0';
 const HOST = process.env.CHATPANEL_BRIDGE_HOST || '127.0.0.1';
@@ -25,6 +26,7 @@ const PORT = Number(process.env.CHATPANEL_BRIDGE_PORT) || 4319;
 const ENGINES = {
   claude: { engine: claude, label: 'Claude Code' },
   codex: { engine: codex, label: 'Codex' },
+  gemini: { engine: gemini, label: 'Gemini CLI' },
 };
 
 // --------------------------------------------------------------------------
@@ -149,5 +151,5 @@ server.listen(PORT, HOST, async () => {
     const a = await engine.available().catch(() => ({ ok: false }));
     log('info', `  ${a.ok ? '✓' : '✕'} ${label}${a.ok ? '' : ' — ' + (a.reason || 'unavailable')}`);
   }
-  log('info', 'Open the ChatPanel side panel; Claude Code & Codex will appear as agents.');
+  log('info', 'Open the ChatPanel side panel; installed agents (Claude Code, Codex, Gemini CLI) appear automatically.');
 });