claudelink-bridge 0.1.2 → 0.1.4

package/README.md

@@ -64,13 +64,104 @@ Download from the [latest GitHub release](https://github.com/devops-monk/claude-
 
 ---
 
-## Auto-start method by platform
+## Auto-start setup 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` |
+Running `npx claudelink-bridge setup` does everything automatically. Here's what happens on each platform and how to verify it worked.
+
+---
+
+### macOS
+
+`setup` creates a **launchd plist** and loads it immediately. The bridge will start automatically every time you log in.
+
+```bash
+npx claudelink-bridge setup
+```
+
+**Verify it's running:**
+```bash
+npx claudelink-bridge status
+# or check directly:
+launchctl list | grep claudelink
+```
+
+**View logs:**
+```bash
+tail -f ~/.claudelink/bridge.log
+```
+
+**If it stops unexpectedly:**
+```bash
+launchctl unload ~/Library/LaunchAgents/com.devops-monk.claudelink.plist
+launchctl load  ~/Library/LaunchAgents/com.devops-monk.claudelink.plist
+```
+
+**Config file location:** `~/Library/LaunchAgents/com.devops-monk.claudelink.plist`
+
+---
+
+### Linux
+
+`setup` creates a **systemd user service** and enables it so it starts on login. No root/sudo required.
+
+```bash
+npx claudelink-bridge setup
+```
+
+**Verify it's running:**
+```bash
+npx claudelink-bridge status
+# or check directly:
+systemctl --user status claudelink
+```
+
+**View live logs:**
+```bash
+journalctl --user -u claudelink -f
+```
+
+**If it stops unexpectedly:**
+```bash
+systemctl --user restart claudelink
+```
+
+**Lingering (start on boot without login):** If you want the bridge to run even when you're not logged in interactively:
+```bash
+loginctl enable-linger $USER
+```
+
+**Config file location:** `~/.config/systemd/user/claudelink.service`
+
+---
+
+### Windows
+
+`setup` creates a **Task Scheduler entry** that runs the bridge at login. Run this in **PowerShell** (no admin required):
+
+```powershell
+npx claudelink-bridge setup
+```
+
+**Verify it's running:**
+```powershell
+npx claudelink-bridge status
+# or check directly in Task Scheduler:
+schtasks /Query /TN ClaudeLinkBridge
+```
+
+**View logs:**
+```powershell
+Get-Content "$env:USERPROFILE\.claudelink\bridge.log" -Wait
+```
+
+**If it stops unexpectedly:**
+```powershell
+schtasks /Run /TN ClaudeLinkBridge
+```
+
+**Manually open Task Scheduler** to verify: press `Win+R` → type `taskschd.msc` → look for `ClaudeLinkBridge` in the task list.
+
+**Config:** Task Scheduler entry named `ClaudeLinkBridge`, visible in Task Scheduler Library.
 
 ---
 
@@ -128,6 +219,30 @@ npx claudelink-bridge setup   # re-registers the service
 
 ---
 
+## Changelog
+
+### 0.1.3
+- Expanded platform setup docs with per-platform verify, log, and restart steps
+
+### 0.1.2
+- Added full README with quick-start, commands, platform setup, troubleshooting, and security sections
+- Added `repository`, `homepage`, `bugs` metadata to package
+- Added `files` whitelist — cleaner published package
+
+### 0.1.1
+- Initial README added
+
+### 0.1.0
+- Initial release
+- WebSocket bridge server on `localhost:9999`
+- Streams Claude Code CLI responses token by token
+- Auto-start service installer for macOS (launchd), Linux (systemd), Windows (Task Scheduler)
+- `setup`, `start`, `stop`, `status`, `kill`, `uninstall` commands
+- Handles screenshots as base64 inline images for Claude
+- 50MB max payload for large screenshots
+
+---
+
 ## Links
 
 - [ClaudeLink Chrome Extension](https://github.com/devops-monk/claude-link)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudelink-bridge",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "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": {