Skip to content
AgentCTX

actx dashboard

actx dashboard

Section titled “actx dashboard”

Start the AgentCTX analytics dashboard — a glassmorphism-styled web UI backed by SurrealDB metrics and Chart.js visualizations.

Usage

Section titled “Usage”
Terminal window
actx dashboard [options]

Options

Section titled “Options”
OptionDefaultDescription
--port <number>3001HTTP port for the dashboard server
--open—Auto-open the dashboard in the default browser

Description

Section titled “Description”

The dashboard serves a complete analytics interface from the templates/dashboard/ directory. It connects to SurrealDB (via SURREAL_URL environment variable) to aggregate real-time metrics about agent activity, token usage, and context pressure.

If SurrealDB is unavailable, the dashboard starts in degraded mode — the UI loads but metrics endpoints return empty data.

Example

Section titled “Example”
Terminal window
$ actx dashboard --port 3001 --open
📊 Dashboard running at http://localhost:3001

Shutdown

Section titled “Shutdown”

Press Ctrl+C to gracefully shut down. The server handles SIGINT and SIGTERM signals, closing the SurrealDB connection cleanly.

See Also

Section titled “See Also”