X Bookmarks 🔖

Turn your X (Twitter) bookmarks from a graveyard of good intentions into an actionable to-do list.

This skill fetches your saved bookmarks, summarizes them, categorizes them by topic, and actively proposes things you can do with them.

Features that make it great

• Action-First Digests: It doesn't just summarize—it tells you what to do. (e.g., "Here's a draft in your voice" or "I can set this tool up for you").
• Flexible Fetching: Works seamlessly with the bird CLI or the official X API v2.
• Duplicate Tracking: Keeps track of what it has already processed so you never see the same bookmark twice.
• Stale Cleanup: Automatically flags bookmarks older than 30 days so you can use them or lose them.
• Agent Ready: Designed to drop right into the OpenClaw framework for autonomous AI processing.

Getting Started

1. Choose your authentication method

Using bird CLI (Recommended)

1. Install it: npm install -g bird-cli
2. Create a .env.bird file with your BIRD_AUTH_TOKEN and BIRD_CT0 (grab these from your browser cookies).

Using X API v2

1. Create an app at developer.x.com.
2. Run python3 scripts/x_api_auth.py --client-id "YOUR_CLIENT_ID" to authenticate.

2. Fetch your bookmarks

You can run the scripts manually:

# Via bird CLI
source .env.bird && bird --auth-token "$BIRD_AUTH_TOKEN" --ct0 "$BIRD_CT0" bookmarks --json

# Via X API v2
python3 scripts/fetch_bookmarks_api.py -n 20

3. Use it as an Agent Skill

If you're using OpenClaw, just place this folder in ~/.agents/skills/x-bookmarks/. The agent will automatically detect your credentials, fetch your bookmarks, categorize them, and propose actions!

Under the Hood

• scripts/ contains the raw Python and Bash fetching logic.
• SKILL.md holds the specific instructions for AI agents to process the raw JSON and generate the actionable digests.
• State is tracked locally in memory/bookmark-state.json.

---

Stop hoarding bookmarks. Start doing things.