cc-sidepanel: Brave/Chrome MV3 side-panel extension for a live Claude Code seat

2026-09-11 01:29:42 +08:00
commit 8d64c86b10
8 changed files with 498 additions and 0 deletions
@@ -0,0 +1,42 @@
+# CC Sidepanel
+
+A Brave/Chrome **MV3 side-panel extension** that puts a live Claude Code seat in your browser sidebar — type in the sidebar, it lands in the real terminal pane. Two-way.
+
+Built by Monica (bridge + extension skeleton), parser and styling pass by Selene, 2026-09-11.
+
+## Pieces
+
+- **`bridge.py`** — a localhost HTTP shim on `:8988`. Browser extensions can't reach a unix socket, so this proxies JSON to `injectd.py`'s socket at `/tmp/injectd.sock` (ops: `seats`, `screen`, `inject`). CORS is locked to one `chrome-extension://` origin — no wildcard.
+- **`extension/`** — MV3 side panel. Polls `/screen` every 1.5s, parses the raw kitty pane into typed blocks (user / assistant / tool / thinking / live-heartbeat / meta), and sends text back via `/inject`.
+
+## Dependencies / pre-reqs
+
+- `injectd.py` is **house infrastructure, not part of this repo.** The bridge expects the socket `/tmp/injectd.sock` to already exist (created by injectd, which runs separately and is shared by every seat).
+- The extension ID is deliberately **not** in the code. `bridge.py` reads `CCSIDEPANEL_EXT_ID` from the environment and refuses to start if it's unset (no silent fallback).
+
+## Setup
+
+1. Load the extension unpacked from `extension/` at `brave://extensions`.
+2. Copy its ID from the `brave://extensions` page.
+3. Create the env file:
+
+   ```bash
+   cp cc-sidepanel.env.example /etc/cc-sidepanel.env
+   # fill in CCSIDEPANEL_EXT_ID=<your-id>
+   ```
+
+4. Start/restart the bridge:
+
+   ```bash
+   systemctl restart cc-sidepanel-bridge   # unit: /etc/systemd/system/cc-sidepanel-bridge.service
+   ```
+
+   The systemd unit runs as `juxtapo` and reads config via `EnvironmentFile=/etc/cc-sidepanel.env` — both files live **outside** the repo (documented here, not committed).
+
+## Gotcha: reloading = new ID
+
+Reloading the extension from a **different path** gives it a **new ID**, and the panel gets CORS-blocked with no visible error. If the panel stops working after a reload, copy the new ID, update `/etc/cc-sidepanel.env`, and restart the unit.
+
+## License
+
+House project — MIT.