summaryrefslogtreecommitdiff
path: root/START_HERE.md
blob: ade3e982c382322d53acfc50c98c462526ea229a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
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!** 🚀