# Quick Start Guide

## 5-Minute Setup

### 1. Get API Keys

#### Todoist (Required)
1. Go to https://todoist.com/app/settings/integrations
2. Scroll to "Developer" section
3. Copy your **API token**

#### Trello (Required)
1. Go to https://trello.com/power-ups/admin
2. Create a Power-Up (any name, e.g., "Personal Dashboard")
3. Go to **API Key** tab
4. Click **"Generate a new API Key"** and copy it (NOT the Secret!)
5. In the API Key description, follow the "testing/for-yourself" instructions
6. Click the **Token** link to generate a personal token
7. Click **"Allow"** and copy the token

**Important:** You need the API Key + Token (NOT the Secret). The Secret is for OAuth and not used for personal access.

**That's it!** You now have everything you need.

### 2. Configure

```bash
# Copy template
cp .env.example .env

# Edit .env and add:
TODOIST_API_KEY=your_todoist_token
TRELLO_API_KEY=your_trello_key
TRELLO_TOKEN=your_trello_token
```

### 3. Run

```bash
go run cmd/dashboard/main.go
```

### 4. Access

Open http://localhost:8080 in your browser!

---

## Optional: Add More Features

### Obsidian Notes
Add to `.env`:
```bash
OBSIDIAN_VAULT_PATH=/path/to/your/vault
```

### Claude.ai Access
```bash
# Generate key
openssl rand -hex 32

# Add to .env
AI_AGENT_API_KEY=generated_key_here
```

Then share with Claude:
- URL: `http://localhost:8080/api/claude/snapshot`
- Token: (your AI_AGENT_API_KEY)

---

## What You'll See

**Main Dashboard:**
- 📋 **Trello Boards** at the top (your primary view)
- ✓ **Todoist Tasks** below
- 📝 **Recent Notes** (if Obsidian configured)
- 🍽️ **Meal Plans** (if PlanToEat configured - optional)

**Features:**
- Auto-refresh every 5 minutes
- Manual refresh button
- Mobile-responsive design
- Fast SQLite caching

---

## Troubleshooting

### Can't start - missing API keys
Make sure your `.env` has:
```bash
TODOIST_API_KEY=something
TRELLO_API_KEY=something
TRELLO_TOKEN=something
```

All three are required. Get them from:
- Todoist: https://todoist.com/app/settings/integrations
- Trello: https://trello.com/power-ups/admin (create Power-Up, generate both from API Key tab)

### No boards showing
- Check your Trello API key and token are correct
- Make sure you have boards in your Trello account
- Click the refresh button

### No tasks showing
- Verify Todoist API token is correct
- Check you have active tasks in Todoist

---

## Next Steps

1. ✅ Dashboard is running
2. Check that data is loading
3. Test the refresh button
4. (Optional) Set up Claude.ai access
5. Start using your unified dashboard!

Need more details? See `SETUP_GUIDE.md` for comprehensive instructions.