Dashboard Overview

The ArgentOS web dashboard — a React UI for chatting, managing tasks, and monitoring your agent.

Overview

The ArgentOS dashboard is a React web application that provides a visual interface for interacting with your agent. It connects to the gateway via WebSocket and provides real-time chat, task management, session history, and system monitoring.

Launching the Dashboard

argent dashboard

This opens the dashboard in your default browser at http://localhost:3141.

The dashboard can also be accessed remotely if the gateway is configured for external access (see Remote Access).

Architecture

Browser (React App)
    │
    ├── WebSocket → Gateway (port 18789)
    │                  └── Agent Runtime
    │
    └── HTTP API → Dashboard API Server (port 3141)
                      └── dashboard.db (SQLite)

The dashboard communicates over two channels:

WebSocket: Real-time chat messages, streaming responses, and live status updates
HTTP API: Task management, session history, and configuration

Dashboard Database

The dashboard maintains its own SQLite database for task data and UI state:

~/.argentos/data/dashboard.db

This database is shared between the dashboard API server and the agent's task tools, ensuring both sides see the same task state.

Requirements

A modern web browser (Chrome, Firefox, Safari, Edge)
Gateway running (argent gateway start)
Node.js for the API server

Configuration

Dashboard settings are in argent.json:

{
  "dashboard": {
    "port": 3141,
    "host": "localhost"
  }
}

Key Pages

Chat: Primary interface for conversing with your agent
Tasks: Task management with create, track, and complete flows
Sessions: View and switch between conversation sessions
Settings: Audio, model, and display preferences