bookmark-intelligence

# 🔖 Bookmark Intelligence

**Turn your X (Twitter) bookmarks into actionable insights, automatically.**

Bookmark Intelligence watches your X bookmarks, fetches the full content from linked articles, analyzes everything with AI, and surfaces ideas relevant to YOUR projects. Stop letting great content sit in your bookmarks — let AI extract the value for you.

---

## 💎 Pricing & Tiers

Bookmark Intelligence offers three tiers to fit your needs:

### 🆓 Free Tier
**Perfect for trying it out**
- **Price:** $0/month
- **10 bookmarks** per month
- Manual run only (no automation)
- Basic keyword analysis (no AI)
- No notifications
- Rate limited: 1 run per hour

### ⭐ Pro Tier - $9/month
**Best for individuals**
- **Unlimited bookmarks**
- Automated monitoring (background daemon)
- Full AI-powered analysis (GPT-4o-mini)
- Telegram notifications
- Priority support

### 🚀 Enterprise Tier - $29/month
**For teams and power users**
- Everything in Pro, plus:
- Team sharing & collaboration
- Custom AI models (bring your own API keys)
- API access for integrations
- Slack & Discord notifications
- Webhook support
- Dedicated support

**Annual plans available** - Save 2 months (16% off)!

### How to Upgrade

1. **Check your current tier:**
   ```bash
   npm run license:check
   ```

2. **View upgrade options:**
   ```bash
   npm run license:upgrade
   ```

3. **Choose payment method:**
   - Credit Card (Stripe)
   - Crypto (USDC on Polygon)

4. **Activate your license:**
   ```bash
   node scripts/license.js activate YOUR-LICENSE-KEY
   ```

---

## 📋 Quick Start

**Total setup time: ~5 minutes**

1. **Run the setup wizard:**
   ```bash
   cd skills/bookmark-intelligence
   npm run setup
   ```

2. **The wizard will:**
   - ✅ Check if you have the required tools installed
   - 🍪 Guide you through getting your X cookies (step-by-step)
   - 🎯 Ask about your active projects & interests
   - ⚙️ Configure notification preferences
   - 🧪 Test your credentials

3. **Run it once to process your current bookmarks:**
   ```bash
   npm start
   ```

4. **Set it up as a background daemon (optional but recommended):**
   ```bash
   npm run daemon
   ```

That's it! You're done. 🎉

---

## 🎯 What It Does

### The Problem
You bookmark tons of great content on X, but:
- You never go back to read it
- The tweets link to articles you don't have time to read
- You forget why you bookmarked something
- You miss connections to your current projects

### The Solution
Bookmark Intelligence:
1. **Monitors** your X bookmarks automatically
2. **Fetches** the full content from any linked articles (not just the tweets)
3. **Analyzes** everything with AI to extract key concepts and actionable items
4. **Relates** insights to YOUR specific projects and interests
5. **Notifies** you (via Telegram) when it finds something valuable
6. **Stores** everything in a searchable knowledge base

### Example Output

You bookmark a tweet about "vector embeddings for AI memory" → The skill:
- Fetches the linked article
- Extracts: key concepts, actionable implementation steps, code patterns
- Relates it to your "trading bot" and "agent memory" projects
- Suggests: "Store market analysis as embeddings to find historical patterns"
- Saves the full analysis to `life/resources/bookmarks/bookmark-123.json`
- Sends you a Telegram notification with the summary

See [examples/sample-analysis.json](examples/sample-analysis.json) for a full example.

---

## 🍪 Getting Your X Cookies (Step-by-Step)

You need two cookies from X.com. Don't worry, this is safe and takes 2 minutes.

### Chrome / Edge / Brave

1. Open https://x.com in your browser
2. **Make sure you're logged in**
3. Press **F12** (opens Developer Tools)
4. Click the **Application** tab at the top
5. In the left sidebar:
   - Expand **Cookies**
   - Click **https://x.com**
6. You'll see a list of cookies. Find these two:
   - `auth_token` → Copy the **Value** column
   - `ct0` → Copy the **Value** column

```
┌─────────────────────────────────────────┐
│ Application  Console  Sources  ...     │ ← Click "Application"
├─────────────────────────────────────────┤
│ ▼ Storage                               │
│   ▼ Cookies                             │
│     ▶ https://x.com      ← Click this   │
│                                         │
│ Name          Value                     │
│ auth_token    abc123...  ← Copy this    │
│ ct0           xyz789...  ← Copy this    │
└─────────────────────────────────────────┘
```

### Firefox

1. Open https://x.com
2. Press **F12**
3. Click **Storage** tab (not "Application")
4. Expand **Cookies** → **https://x.com**
5. Copy `auth_token` and `ct0` values

### Safari

1. Enable Developer menu:
   - Safari → Preferences → Advanced
   - Check "Show Develop menu in menu bar"
2. Go to https://x.com
3. Develop → Show Web Inspector
4. Storage tab → Cookies → x.com
5. Copy `auth_token` and `ct0`

### ⚠️ Important Security Notes

- **These cookies are like your password** - they give full access to your X account
- **Never share them with anyone**
- **Don't post them online or commit them to git**
- They're stored locally in `.env` with strict permissions (600 = only you can read)
- They expire periodically - you'll need to update them (the skill will tell you)

The setup wizard creates a `.env` file that looks like this:
```bash
AUTH_TOKEN=your_long_token_here
CT0=your_other_token_here
```

---

## 🛠️ Requirements

### Required
- **Node.js** v16+ ([download here](https://nodejs.org))
- **bird CLI** - X/Twitter command-line tool
  ```bash
  npm install -g bird
  ```

### Optional (but recommended)
- **PM2** - For running as a background daemon
  ```bash
  npm install -g pm2
  ```

The setup wizard checks all of this automatically!

---

## ⚙️ Configuration

After running `npm run setup`, you'll have two files:

### 1. `.env` - Your Credentials
```bash
AUTH_TOKEN=your_token_here
CT0=your_ct0_here
```
**Never commit this file!** It's in `.gitignore`.

### 2. `config.json` - Your Preferences
```json
{
  "credentialsFile": ".env",
  "bookmarkCount": 50,
  "checkIntervalMinutes": 60,
  "storageDir": "../../life/resources/bookmarks",
  "notifyTelegram": true,
  "contextProjects": [
    "trading bot",
    "agent memory",
    "your other projects..."
  ]
}
```

**Key settings:**
- `bookmarkCount` - How many recent bookmarks to check (default: 50)
- `checkIntervalMinutes` - How often to check for new bookmarks (default: 60)
- `contextProjects` - **Your active projects** - the more specific, the better the AI analysis!
- `notifyTelegram` - Get notified about high-value insights (requires OpenClaw)

You can edit `config.json` anytime. Changes take effect on next run.

---

## 🚀 Usage

### Run Once (Process Current Bookmarks)
```bash
npm start
```
Processes your recent bookmarks once and exits.

### Test Mode (See What Would Happen)
```bash
npm test
```
Shows what it would process without actually doing it.

### Background Daemon (Recommended for Daily Use)
```bash
npm run daemon
```

This runs Bookmark Intelligence in the background, checking for new bookmarks every hour (configurable).

**Managing the daemon:**
```bash
pm2 status bookmark-intelligence   # Check if it's running
pm2 logs bookmark-intelligence     # View recent logs
pm2 stop bookmark-intelligence     # Pause it
pm2 restart bookmark-intelligence  # Restart it
pm2 delete bookmark-intelligence   # Remove it completely
```

---

## 📂 Where Does Everything Go?

```
skills/bookmark-intelligence/
├── .env                    # Your credentials (SECRET - never commit!)
├── config.json             # Your preferences
├── bookmarks.json          # Processing state (tracks what's been analyzed)
├── monitor.js              # Main script
├── analyzer.js             # AI analysis engine
├── scripts/
│   ├── setup.js           # Setup wizard
│   └── uninstall.js       # Clean uninstall
└── examples/              # Sample outputs to show you what to expect

life/resources/bookmarks/   # ← Analyzed bookmarks saved here
├── bookmark-123.json
├── bookmark-456.json
└── ...
```

Each analyzed bookmark becomes a JSON file with:
- The original tweet (author, text, engagement stats)
- Full analysis (summary, key concepts, actionable items)
- Implementation suggestions for YOUR projects
- Priority level
- Timestamp

---

## 🔔 Notifications (OpenClaw Integration)

If you're running this inside OpenClaw (not standalone), you can get Telegram notifications for high-value insights.

**What triggers a notification:**
- `priority: "high"` AND
- `hasActionableInsights: true`

**What you get:**
- 📚 Summary of the content
- 🎯 List of actionable items
- 💡 Key concepts
- 🔨 Implementation suggestions for your projects
- 🔗 Link to the original tweet

See [examples/sample-notification.md](examples/sample-notification.md) for a full example.

---

## 🧹 Uninstalling

```bash
npm run uninstall
```

This will:
1. Stop the PM2 daemon (if running)
2. Delete your credentials (`.env`)
3. Delete configuration (`config.json`)
4. Delete processing state (`bookmarks.json`)
5. **Ask** if you want to keep your analyzed bookmarks

To reinstall later, just run `npm run setup` again.

---

## 🔧 Troubleshooting

### "Missing Twitter credentials" error

**Problem:** The skill can't find your auth tokens.

**Solution:**
1. Make sure you ran `npm run setup`
2. Check that `.env` exists in `skills/bookmark-intelligence/`
3. Check that `.env` has both `AUTH_TOKEN=` and `CT0=` lines

### "No bookmarks fetched" or "unauthorized" error

**Problem:** Your cookies are invalid or expired.

**Solution:**
1. Get fresh cookies from X.com (see instructions above)
2. Update `.env` with new values
3. Try running `npm test` to verify

**To manually test your credentials:**
```bash
cd skills/bookmark-intelligence
source .env
bird whoami --json
```
If this works, your credentials are valid.

### "bird: command not found"

**Problem:** bird CLI isn't installed.

**Solution:**
```bash
npm install -g b

... (truncated)