Chrome Extension

Manifest V3 Chrome extension that connects to your PiEEG server and overlays real-time cognitive state insights on any webpage.

System flow:

PiEEG Hardware → PiEEG-server → Chrome Extension
                      ↓
                PiEEG-agent (optional AI copilot)

Prerequisites

Required: PiEEG-server running

pieeg-server          # starts at http://localhost:1617
pieeg-server --mock   # no hardware needed

Optional: PiEEG-agent for AI-powered insights

pieeg-agent web       # starts AI copilot at http://localhost:8000

Install

git clone https://github.com/pieeg-club/PiEEG-chrome.git

Features

Toolbar Popup

• Status indicator — checks http://localhost:1617/api/info; green (running), red (offline), yellow (checking)
• Server version displayed when connected
• Open Dashboard — opens http://localhost:1617 in a new tab
• WS port copy — copies ws://localhost:1616 to clipboard
• Configurable port — change HTTP port in the settings row (persisted via chrome.storage.sync)

Brain Insights Overlay

A draggable, on-page HUD that turns live band power into real-time cognitive-state estimates.

Each index is normalized to an adaptive within-session baseline (EWMA z-score → logistic), so every level is relative to your own recent activity. Confidence reflects baseline coverage and live signal stability. All formulas and caveats are shown in an expandable details panel.

Toggle from the popup. Drag anywhere on the page. Expand Method & raw signals for raw band values and index formulas.

Neural Feedback Assistant

AI-powered chat copilot overlay (requires PiEEG-agent on port 8000).

• Natural language conversations about your brain state
• Live brain state bars (Focus, Calm, Engagement, Workload)
• Pattern training guidance and signal analysis
• Connectivity exploration
• Draggable glass morphism panel, minimizable
• Streams via ws://localhost:8000/ws/chat and ws://localhost:8000/ws/live

Click "Show Neural Assistant" in the popup to open on any tab.

Auto-Update Notifications

The extension checks GitHub main on open and every 6 hours. When an update is available, a green dot appears on the toolbar icon and a banner appears in the popup.

Updating

git pull

Then click Reload in the popup banner. No need to visit chrome://extensions.

Default Ports

Change the HTTP port in the extension's settings row if you run the server on a different port.

Permissions

Project Structure

PiEEG-chrome/
├── manifest.json       # Manifest V3
├── popup.html          # Extension popup UI
├── popup.js            # Status check + button logic
├── chat-assistant.js   # Neural Feedback Assistant overlay
├── overlay.js          # Brain Insights on-page HUD
├── background.js       # Service worker: update checker + spectrum proxy
├── update.js           # Shared update-check helpers
└── icons/
    ├── icon16.png
    ├── icon48.png
    └── icon128.png