# Rook — Quick Start Guide

You have a personal AI agent running on dedicated hardware in your home. Here's how to use it.

---

## Talk To Your Agent

### Option 1: Telegram (Recommended)
Open Telegram on your phone and message your bot. Just talk to it naturally:
- "What's the weather like today?"
- "Draft an email to my team about the project update"
- "Research the best restaurants in downtown for tonight"
- "Help me write a cover letter"

### Option 2: Dashboard
Open your browser and go to: **http://hermes.local:3080**
(Or use the IP address: `http://192.168.x.x:3080`)

The dashboard gives you a chat interface plus access to settings, memory, skills, and more.

---

## What Your Agent Can Do

Your agent has tools. It can:

| Capability | Examples |
|-----------|---------|
| **Web Research** | "Look up the latest news about X" |
| **Code** | "Write a Python script that..." |
| **Email** | "Check my inbox" / "Send an email to..." |
| **Files** | "Create a document about..." |
| **Memory** | "Remember that I prefer..." |
| **Scheduling** | "Remind me every day at 9am to..." |
| **Analysis** | "Analyze this data..." / "Compare these options..." |

Just ask in plain English. The agent figures out which tools to use.

---

## Useful Commands (Telegram)

| Type This | What Happens |
|-----------|-------------|
| `/help` | See all commands |
| `/new` | Start a fresh conversation |
| `/model` | See or change the AI model |
| `/status` | Check what's going on |
| `/verbose` | Toggle technical details on/off |

Full command list: See `telegram-commands.md`

---

## Your Data Is Protected

- All conversations stay on YOUR device
- Backups are encrypted before leaving the device
- Your home IP is masked (if VPN is configured)
- API keys are stored securely, never shared

---

## If Something Goes Wrong

1. **Agent not responding?** Wait 2 minutes — the watchdog auto-restarts it
2. **Bad AI responses?** Type `/model` to switch to a different model
3. **Need a fresh start?** Type `/new` to clear the conversation
4. **Dashboard down?** It'll come back automatically. If not, ask someone to run `rook restart` on the device

---

## Getting Help

Just ask your agent! It can help you with its own features:
- "What commands can I use?"
- "How do I change your personality?"
- "Can you check if my email is set up?"

---

*Your agent gets better the more you use it. It learns your preferences, remembers context, and develops skills from experience.*