1 files changed, 113 insertions, 0 deletions
diff --git a/START_HERE.md b/START_HERE.md
new file mode 100644
index 0000000..ade3e98
--- /dev/null
+++ b/START_HERE.md
@@ -0,0 +1,113 @@
+# 👋 START HERE
+
+Welcome to your Personal Consolidation Dashboard!
+
+## First Time Setup (5 minutes)
+
+### Step 1: Get Your API Keys
+
+You need two things:
+
+1. **Todoist Token**
+   - Go to: https://todoist.com/app/settings/integrations
+   - Copy your API token
+
+2. **Trello Key + Token**
+   - Go to: https://trello.com/power-ups/admin
+   - Create a Power-Up (or select existing one)
+   - Go to **API Key** tab → Click **"Generate a new API Key"**
+   - Copy the **API Key** (NOT the Secret!)
+   - In the description below the API Key, find the "testing/for-yourself" instructions
+   - Click the **Token** link → Click **Allow** → Copy the token
+   - **Important:** You need API Key + Token, NOT the Secret
+
+### Step 2: Configure
+
+```bash
+# Copy the example file
+cp .env.example .env
+
+# Open .env in your editor and add:
+TODOIST_API_KEY=paste_your_todoist_token_here
+TRELLO_API_KEY=paste_your_trello_key_here
+TRELLO_TOKEN=paste_your_trello_token_here
+```
+
+### Step 3: Run
+
+```bash
+go run cmd/dashboard/main.go
+```
+
+### Step 4: Open Browser
+
+Go to: **http://localhost:8080**
+
+You should see:
+- ✅ Your Trello boards at the top
+- ✅ Your Todoist tasks below
+- ✅ Auto-refresh working
+
+**Done!** 🎉
+
+---
+
+## What Next?
+
+### Optional: Add Obsidian Notes
+If you use Obsidian, add to `.env`:
+```bash
+OBSIDIAN_VAULT_PATH=/path/to/your/vault
+```
+
+### Optional: Claude.ai Integration
+Want me (Claude) to access your dashboard?
+
+1. Generate a key:
+   ```bash
+   openssl rand -hex 32
+   ```
+
+2. Add to `.env`:
+   ```bash
+   AI_AGENT_API_KEY=paste_generated_key_here
+   ```
+
+3. Share with me:
+   - URL: `http://localhost:8080/api/claude/snapshot`
+   - Token: (your AI_AGENT_API_KEY)
+
+Then I can help you with "What's due today?" and more!
+
+---
+
+## Troubleshooting
+
+### Server won't start
+**Error:** "TODOIST_API_KEY is required"
+
+**Fix:** Make sure `.env` has all three:
+```bash
+TODOIST_API_KEY=...
+TRELLO_API_KEY=...
+TRELLO_TOKEN=...
+```
+
+### No Trello boards showing
+**Fix:** Check you got **both** from https://trello.com/power-ups/admin:
+1. API Key (from Power-Up's "API Key" tab)
+2. Token (click "Token" link next to API key)
+
+### Need more help?
+See **[QUICKSTART.md](QUICKSTART.md)** for more details.
+
+---
+
+## Next Steps
+
+- ✅ **Dashboard is running!**
+- 📖 Read [PROJECT_SUMMARY.md](PROJECT_SUMMARY.md) for overview
+- 🔧 See [SETUP_GUIDE.md](SETUP_GUIDE.md) for advanced setup
+- 🤖 Check [AI_AGENT_SETUP.md](AI_AGENT_SETUP.md) for Claude integration
+
+**Happy organizing!** 🚀