> For the complete documentation index, see [llms.txt](https://docs.atlas-ai.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.atlas-ai.org/features/dashboard.md).

# Dashboard & Visualization

## Two Ways to Access

ATLAS provides two dashboard interfaces:

### 🖥️ Terminal Dashboard (TUI)

A rich terminal interface for power users who live in the command line.

### 🌐 Web Dashboard

A modern Next.js application with interactive visualizations at [dashboard.atlas-ai.org](https://dashboard.atlas-ai.org).

***

## Web Dashboard Features

### Knowledge Graph Visualization

The centerpiece: an interactive D3.js graph showing your concepts and their connections.

**Interactions:**

* **Pan and zoom** through the knowledge network
* **Click nodes** to see details and connections
* **Hover** for quick previews
* **Filter** by concept type, importance, or date
* **Search** to highlight matching nodes

**Visual Encoding:**

* **Node size** reflects importance score
* **Node color** indicates category/domain
* **Edge thickness** shows relationship strength
* **Clusters** reveal knowledge domains

### Search Interface

Universal search across your entire knowledge base:

* Full-text search with relevance ranking
* Filter by content type (concepts, insights, actions)
* Date range filtering
* Source filtering (Twitter, Notes, etc.)
* Importance threshold

### Statistics Dashboard

At-a-glance metrics:

| Metric          | What It Shows               |
| --------------- | --------------------------- |
| Total Concepts  | Size of your knowledge base |
| Content Items   | Original source documents   |
| Relationships   | Connections in the graph    |
| Insights        | Extracted learnings         |
| Actions         | Pending tasks               |
| Recent Activity | Latest additions            |

### Action Queue

Manage your knowledge-derived tasks:

* View prioritized actions
* Mark items complete
* Add new actions manually
* Link actions to concepts

### Agent Control Panel

Run and monitor AI agents:

* Launch agent tasks
* View agent status
* Review agent outputs
* Access agent logs

***

## Terminal Dashboard (TUI)

For those who prefer the command line:

```bash
atlas dashboard
```

**Features:**

* Rich text tables and formatting
* Keyboard navigation
* Quick search
* Stats overview
* Recent content preview

Built with Python's Rich library for a beautiful terminal experience.

***

## Dashboard Architecture

### Frontend Stack

* **Next.js 16** — React framework with App Router
* **shadcn/ui** — Component library
* **D3.js** — Graph visualization
* **TailwindCSS** — Styling
* **TypeScript** — Type safety

### Backend Integration

* **REST API** — 45+ endpoints
* **WebSocket** — Real-time updates (coming)
* **MCP Server** — AI tool integration

### Responsive Design

The web dashboard works on:

* Desktop (full experience)
* Tablet (adapted layout)
* Mobile (essential features)

***

## Key Views

### Graph Explorer

Navigate your knowledge visually. Start from any concept and explore outward through connections.

### Concept Detail

Click any concept to see:

* Full description
* Importance score and history
* Related concepts (ranked by connection strength)
* Source content
* Derived insights
* Associated actions

### Content Browser

Browse original source material:

* Filter by source (Twitter, Notes, etc.)
* Sort by date, importance, or relevance
* Preview content inline
* Jump to extracted concepts

### Insights Feed

Chronological view of extracted insights:

* Recent learnings
* High-importance insights
* Action-generating insights

***

## Access & Deployment

### Public Dashboard

A read-only public dashboard is available at:

* [dashboard.atlas-ai.org](https://dashboard.atlas-ai.org)

### Self-Hosted

Run your own dashboard:

```bash
cd dashboard
pnpm install
pnpm dev --port 3333
```

### API Server

The dashboard connects to the ATLAS API:

```bash
uvicorn atlas.api.main:app --port 8888
```

***

## Coming Soon

* **Real-time sync** — Watch knowledge graph update live
* **Collaboration** — Share views with others
* **Custom views** — Save filtered graph states
* **Export** — Download visualizations as images
* **Embedding** — Embed graphs in other sites


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.atlas-ai.org/features/dashboard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
