claudelink-bridge 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,140 @@
+# claudelink-bridge
+
+**Bridge your browser to Claude Code CLI.**
+
+The local server for the [ClaudeLink Chrome extension](https://github.com/devops-monk/claude-link). Send screenshots, selected text, page content, and custom commands from any webpage directly to your local Claude Code — without leaving the browser.
+
+[![npm](https://img.shields.io/npm/v/claudelink-bridge?color=7c3aed&label=npm)](https://www.npmjs.com/package/claudelink-bridge)
+[![license](https://img.shields.io/npm/l/claudelink-bridge?color=7c3aed)](LICENSE)
+[![node](https://img.shields.io/node/v/claudelink-bridge?color=7c3aed)](https://nodejs.org)
+[![platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-7c3aed)](#installation)
+
+---
+
+## How it works
+
+```
+Chrome Extension  ←── WebSocket (localhost:9999) ──→  claudelink-bridge  ──→  claude CLI
+```
+
+The bridge runs a local WebSocket server. The ClaudeLink extension connects to it, sends prompts and context, and the bridge passes them to your local `claude` binary — streaming the response back token by token. **Everything stays on your machine.**
+
+---
+
+## Quick start
+
+**Step 1 — Install Claude Code CLI** (if you haven't already)
+
+```bash
+npm install -g @anthropic-ai/claude-code
+claude   # log in
+```
+
+**Step 2 — Install the bridge as a background service**
+
+```bash
+npx claudelink-bridge setup
+```
+
+That's it. The bridge starts automatically on every login — no manual steps after this.
+
+**Step 3 — Install the ClaudeLink Chrome extension**
+
+Download from the [latest GitHub release](https://github.com/devops-monk/claude-link/releases/latest), unzip, and load it in `chrome://extensions` with Developer Mode enabled.
+
+---
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `npx claudelink-bridge setup` | Install as auto-start background service (**run once**) |
+| `npx claudelink-bridge start` | Run manually in the foreground |
+| `npx claudelink-bridge status` | Check if the service is running |
+| `npx claudelink-bridge stop` | Stop the background service |
+| `npx claudelink-bridge kill` | Force-kill whatever is on port 9999 |
+| `npx claudelink-bridge uninstall` | Remove the background service |
+
+---
+
+## Requirements
+
+- **Node.js** v18+
+- **Claude Code CLI** — `npm install -g @anthropic-ai/claude-code`
+
+---
+
+## Auto-start method by platform
+
+| Platform | Method | Config location |
+|----------|--------|----------------|
+| **macOS** | launchd | `~/Library/LaunchAgents/com.devops-monk.claudelink.plist` |
+| **Linux** | systemd user service | `~/.config/systemd/user/claudelink.service` |
+| **Windows** | Task Scheduler | Task name: `ClaudeLinkBridge` |
+
+---
+
+## Configuration
+
+**Custom port** (default: `9999`):
+
+```bash
+CLAUDELINK_PORT=9998 npx claudelink-bridge setup
+```
+
+Then update the port in the extension popup → **Settings → Bridge port**.
+
+**Logs** (macOS/Linux):
+
+```bash
+tail -f ~/.claudelink/bridge.log        # live output
+cat ~/.claudelink/bridge-error.log      # errors
+```
+
+---
+
+## Troubleshooting
+
+**Red dot / "Disconnected" in extension**
+```bash
+npx claudelink-bridge status
+npx claudelink-bridge start
+```
+
+**Port already in use**
+```bash
+npx claudelink-bridge kill
+npx claudelink-bridge start
+```
+
+**"Failed to start claude"** — Claude Code CLI not found or not logged in:
+```bash
+npm install -g @anthropic-ai/claude-code
+claude
+```
+
+**Bridge stopped after system update**
+```bash
+npx claudelink-bridge setup   # re-registers the service
+```
+
+---
+
+## Security
+
+- Accepts connections **only from `chrome-extension://` origins** — no other apps or websites can connect
+- All data stays local — the bridge only talks to your local `claude` binary
+- No telemetry, no analytics, no external requests
+
+---
+
+## Links
+
+- [ClaudeLink Chrome Extension](https://github.com/devops-monk/claude-link)
+- [Claude Code CLI docs](https://docs.anthropic.com/en/docs/claude-code)
+- [Report an issue](https://github.com/devops-monk/claude-link/issues)
+- [DevOps-Monk](https://devops-monk.com)
+
+---
+
+MIT © [DevOps-Monk](https://devops-monk.com)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claudelink-bridge",
-  "version": "0.1.0",
-  "description": "Local bridge server connecting ClaudeLink Chrome extension to Claude Code CLI",
+  "version": "0.1.2",
+  "description": "Bridge your browser to Claude Code CLI. The local server for the ClaudeLink Chrome extension — send screenshots, page content, and custom commands from any webpage directly to Claude Code.",
   "type": "module",
   "bin": {
     "claudelink-bridge": "bin/cli.js"
@@ -9,6 +9,11 @@
   "scripts": {
     "start": "node lib/server.js"
   },
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md"
+  ],
   "dependencies": {
     "ws": "^8.18.0"
   },
@@ -18,9 +23,28 @@
   "keywords": [
     "claude",
     "claude-code",
-    "cli",
-    "chrome-extension"
+    "claude-code-cli",
+    "anthropic",
+    "chrome-extension",
+    "browser-extension",
+    "ai",
+    "llm",
+    "devtools",
+    "websocket",
+    "bridge",
+    "devops"
   ],
-  "author": "DevOps-Monk",
-  "license": "MIT"
+  "author": {
+    "name": "DevOps-Monk",
+    "url": "https://devops-monk.com"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/devops-monk/claude-link#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devops-monk/claude-link.git"
+  },
+  "bugs": {
+    "url": "https://github.com/devops-monk/claude-link/issues"
+  }
 }

package/bridge.js

@@ -1,92 +0,0 @@
-#!/usr/bin/env node
-// ClaudeLink bridge — run once: node bridge/bridge.js
-// Connects Claude Code CLI to the browser extension via WebSocket.
-
-import { WebSocketServer } from 'ws';
-import { spawn } from 'child_process';
-import { writeFileSync, unlinkSync } from 'fs';
-import { tmpdir } from 'os';
-import { join } from 'path';
-
-const PORT = process.env.CLAUDELINK_PORT ? parseInt(process.env.CLAUDELINK_PORT) : 9999;
-const ALLOWED_ORIGIN = 'chrome-extension://';
-
-const wss = new WebSocketServer({ port: PORT });
-
-console.log(`\n⚡ ClaudeLink bridge running on ws://localhost:${PORT}`);
-console.log(`   Waiting for extension to connect…\n`);
-
-wss.on('connection', (ws, req) => {
-  const origin = req.headers['origin'] ?? '';
-  if (!origin.startsWith(ALLOWED_ORIGIN)) {
-    ws.close(1008, 'Forbidden');
-    return;
-  }
-
-  console.log(`[+] Extension connected`);
-
-  ws.on('message', async (raw) => {
-    let msg;
-    try { msg = JSON.parse(raw.toString()); }
-    catch { ws.send(JSON.stringify({ type: 'error', text: 'Invalid JSON' })); return; }
-
-    if (msg.type === 'ping') {
-      ws.send(JSON.stringify({ type: 'pong' }));
-      return;
-    }
-
-    if (msg.type === 'prompt') {
-      console.log(`[>] Prompt: ${String(msg.prompt).slice(0, 80)}…`);
-      runClaude(['--print', msg.prompt], ws);
-      return;
-    }
-
-    if (msg.type === 'file-prompt') {
-      const tmpFile = join(tmpdir(), `claudelink-${Date.now()}.md`);
-      writeFileSync(tmpFile, msg.content);
-      console.log(`[>] File prompt: ${tmpFile}`);
-      runClaude(['-p', tmpFile], ws, () => { try { unlinkSync(tmpFile); } catch {} });
-      return;
-    }
-
-    if (msg.type === 'run-script') {
-      const tmpScript = join(tmpdir(), `claudelink-script-${Date.now()}.sh`);
-      writeFileSync(tmpScript, msg.script, { mode: 0o755 });
-      console.log(`[>] Running script: ${tmpScript}`);
-      runScript(tmpScript, ws, () => { try { unlinkSync(tmpScript); } catch {} });
-      return;
-    }
-  });
-
-  ws.on('close', () => console.log(`[-] Extension disconnected`));
-});
-
-function runClaude(args, ws, onClose) {
-  const proc = spawn('claude', args, { env: { ...process.env } });
-  proc.stdout.on('data', (d) => ws.send(JSON.stringify({ type: 'chunk', text: d.toString() })));
-  proc.stderr.on('data', (d) => ws.send(JSON.stringify({ type: 'error', text: d.toString() })));
-  proc.on('close', (code) => {
-    onClose?.();
-    ws.send(JSON.stringify({ type: 'done', exitCode: code }));
-    console.log(`[✓] Done (exit ${code})`);
-  });
-  proc.on('error', (e) => {
-    ws.send(JSON.stringify({ type: 'error', text: `Failed to start claude: ${e.message}\nMake sure Claude Code CLI is installed: npm install -g @anthropic-ai/claude-code` }));
-    ws.send(JSON.stringify({ type: 'done', exitCode: 1 }));
-  });
-}
-
-function runScript(scriptPath, ws, onClose) {
-  const proc = spawn('bash', [scriptPath], { env: { ...process.env } });
-  proc.stdout.on('data', (d) => ws.send(JSON.stringify({ type: 'chunk', text: d.toString() })));
-  proc.stderr.on('data', (d) => ws.send(JSON.stringify({ type: 'error', text: d.toString() })));
-  proc.on('close', (code) => {
-    onClose?.();
-    ws.send(JSON.stringify({ type: 'done', exitCode: code }));
-    console.log(`[✓] Script done (exit ${code})`);
-  });
-  proc.on('error', (e) => {
-    ws.send(JSON.stringify({ type: 'error', text: `Script error: ${e.message}` }));
-    ws.send(JSON.stringify({ type: 'done', exitCode: 1 }));
-  });
-}