bkrigmo1-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/