# Rook Nerve Dashboard — User Guide

Your agent's control center. Access it from any device on your network.

**URL:** `http://hermes.local:3080` (or use the IP address shown during setup)

---

## Layout

The dashboard has three main areas:

```
┌──────────┬────────────────────────┬────────────────────────┐
│          │                        │                        │
│ Sessions │       Chat Panel       │    Workspace Tabs      │
│ Sidebar  │                        │                        │
│          │  [Model Selector ▾]    │  Memory | Skills |     │
│          │                        │  Cron | Files | Fleet  │
│          │  Message history       │  Kanban | Stats |      │
│          │                        │  Voice | Sessions |    │
│          │  [Type a message...]   │  Config               │
│          │                        │                        │
└──────────┴────────────────────────┴────────────────────────┘
```

---

## Chat Panel (Left Side)

This is where you chat with your agent, just like in Telegram.

### Model Selector
At the top of the chat, you'll see the current AI model. Click it to:
- **Switch models** — choose from any model your provider offers
- **Switch providers** — if you have multiple API keys configured
- **Filter to free models** — toggle to only show models that don't cost money

### Chatting
- Type your message and press Enter (or click the send button)
- The agent can use tools (web search, code, files, email) — just ask
- Click "New conversation" to start fresh

---

## Workspace Tabs (Right Side)

### Memory
View and edit what your agent remembers about you. The agent builds this over time from your conversations.

### Skills
Browse, install, and manage skills. Skills teach your agent new capabilities.

### Cron
Scheduled tasks — things your agent does automatically. Examples:
- Email inbox organization (every 2 hours)
- Research tasks on a schedule
- Daily summaries

### Files
Browse files on the device. Your agent can read and create files.

### Fleet
Multi-agent view (when running multiple agent instances).

### Kanban
Task board — manage projects and to-dos visually.

### Stats
Token usage, cost tracking, and performance metrics.

### Voice
Voice controls — text-to-speech and speech-to-text settings.

### Sessions
**Conversation History** — browse all past conversations across platforms (Telegram, email, dashboard). Click any session to read the full conversation. Tool calls are filtered out so you only see the actual dialogue.

### Config
System settings:

**AI Providers** — manage your API keys:
- See which providers are configured (green dot = key saved)
- Click a provider to add, test, or remove its API key
- "Get a free API key" links take you directly to the signup page
- "Test & Save" verifies the key works before saving

**Other settings:**
- Token & cost controls
- Voice & speech settings
- Memory & learning toggles
- Personality selection
- Platform connections (Telegram, Discord, etc.)
- Sub-agent delegation settings

---

## Status Indicators

### Header Bar
- **Green dot + "Online"** — agent is connected and responding
- **Red dot + "Offline"** — agent gateway is not reachable

### Status Bar (Bottom)
- Connection status
- Agent version
- Keyboard shortcut hint (⌘K for command palette)

---

## Keyboard Shortcuts

| Shortcut | Action |
|----------|--------|
| `Enter` | Send message |
| `Shift+Enter` | New line in message |
| `⌘K` / `Ctrl+K` | Open command palette |

---

## Troubleshooting

**Agent shows "Offline":**
- The agent gateway may need a restart. SSH into the device and run: `rook restart`
- Or wait 2 minutes — the watchdog (rook-doctor) will auto-restart crashed services

**Chat isn't responding:**
- Check if a model is selected (top of chat panel)
- Try switching models via the model selector
- Check the Config tab to make sure an API key is configured

**Dashboard won't load:**
- Make sure you're on the same network as the device
- Try the IP address directly: `http://192.168.x.x:3080`
- SSH into the device and run: `rook status`

**I want to reset everything:**
- `/new` in the chat starts a fresh conversation
- To fully reset, SSH in and run: `rook restart`

---

*Last updated: 2026-04-03*