AI Commander Dashboard
A companion dashboard for AI Commander agents. Displays inbound emails collected by the email-webhook skill and shows the status of browser sessions created by the browser-auth skill.
This skill is a read-only viewer — it does not capture credentials, control browsers, or send messages. It simply reads local data files and serves them via a token-protected web UI.
Companion Skills
| Skill | What it does |
|---|---|
email-webhook | Receives inbound emails and writes them to inbox.jsonl |
browser-auth | Runs a remote browser tunnel and writes session data to session.json |
This dashboard reads both files and displays them in one place.
What This Skill Does
- Reads
inbox.jsonland displays the last 50 inbound emails - Reads
session.jsonand shows whether an active browser session exists - Serves a token-gated web UI on a configurable local port
- Refreshes automatically every 5 seconds
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
DASHBOARD_TOKEN | Yes | — | Secret token for accessing the dashboard. |
PORT | No | 19195 | Port for the web dashboard. |
DASHBOARD_HOST | No | 127.0.0.1 | IP to bind the dashboard to. |
INBOX_PATH | No | ./data/inbox.jsonl | Path to inbound email data (from email-webhook). |
SESSION_PATH | No | ./data/session.json | Path to session file (from browser-auth). |
Setup
- Install dependencies:
npm install express@4.21.2 - Start (zero config needed):
node scripts/server.js - Read the printed URL — it includes the auto-generated token:
🏠 AI COMMANDER DASHBOARD READY Access URL: http://YOUR_IP:19195/?token=a3f9c2...
That's it. No configuration required.
Optional Environment Variables
Override defaults only if needed:
| Variable | Default | Description |
|---|---|---|
DASHBOARD_TOKEN | (random) | Custom token instead of auto-generated |
PORT | 19195 | Server port |
DASHBOARD_HOST | 0.0.0.0 | Bind address |
INBOX_PATH | ./data/inbox.jsonl | Path to email data (from email-webhook) |
SESSION_PATH | ./data/session.json | Path to session file (from browser-auth) |
Security
- A fresh random token is generated on every start if
DASHBOARD_TOKENis not set - All requests require the token (
?token=,X-Dashboard-Tokenheader, orAuthorization: Bearer) - The UI stores the token in
localStorageand removes it from the URL after load