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:
bash npm install express@4.21.2 - Start (zero config needed):
bash 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
