> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argentos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```bash theme={null}
argent dashboard
```

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

<Tip>
  The dashboard can also be accessed remotely if the gateway is configured for external access. See [Remote Access](/gateway/remote-access).
</Tip>

## Architecture

```mermaid theme={null}
graph TD
    Browser["Browser (React App)"]
    GW["Gateway (port 18789)"]
    API["Dashboard API Server (port 3141)"]
    Agent["Agent Runtime"]
    DB["dashboard.db (SQLite)"]

    Browser -->|WebSocket| GW
    GW --> Agent
    Browser -->|HTTP API| API
    API --> DB
```

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

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

## 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`:

```json theme={null}
{
  "dashboard": {
    "port": 3141,
    "host": "localhost"
  }
}
```

## Key Pages

<CardGroup cols={2}>
  <Card title="Chat" icon="comments">
    Primary interface for conversing with your agent
  </Card>

  <Card title="Tasks" icon="list-check">
    Task management with create, track, and complete flows
  </Card>

  <Card title="Sessions" icon="clock-rotate-left">
    View and switch between conversation sessions
  </Card>

  <Card title="Settings" icon="gear">
    Audio, model, and display preferences
  </Card>
</CardGroup>