Skip to main content

​
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

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