HelperBox

A tiny draggable helper you can inject into any page to chat, preview, and inspect the current site — served locally.

Quick start

Run the local server and inject the helper into any page with a single line.

Start server

# from the project 'HelperBox' directory
python3 server.py
# or
./run.sh

Inject helper

Open any website in your browser and run this in the address bar or the console:

javascript:import("https://cosm1c.netlify.app/bridge.js")

Tip: on HTTPS pages you may need to allow mixed content or load the server over HTTPS.

Controls

  • Close (hide): click the ✖ in the helper.
  • Toggle: press Ctrl+B to show/hide the helper.
  • Drag: grab the blue header to move the helper around.
  • Preview: visit frame.html to see the stored snapshot and a chat panel.

What it does

  • Snapshots the current page (removes the helper before saving).
  • Posts the snapshot to the local server and to the helper iframe.
  • Provides a simple chat shared between the helper and the preview page.
  • Lightweight — no build step required.

Files of interest

  • bridge.js — the injector script you load into pages.
  • frame.html — the viewer that renders previews + chat.
  • server.py — minimal Python server with endpoints for saving snapshots and chat.
  • run.sh — helper script to start the server quickly.

Troubleshooting

  • If the helper doesn't appear, check your browser console for errors and ensure the server is running on /bridge.js.
  • If injection fails on HTTPS sites, either allow mixed content for localhost or run the server with HTTPS (not included by default).
  • If the ✖ doesn't hide the helper, press Ctrl+B to toggle visibility.
  • To reset chat or preview, delete chat.json and last_host.html in the folder and refresh.