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.jsonl and displays the last 50 inbound emails
Reads session.json and 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

|---|---|---|---|

| 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. |

Setup

Install dependencies:

```bash

npm install [email protected]

```

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_TOKEN is not set
All requests require the token (?token=, X-Dashboard-Token header, or Authorization: Bearer)
The UI stores the token in localStorage and removes it from the URL after load