v2.0.4 — Auto-pagination + budget modes

What's New

• Auto-paginate briefing to capture all posts/mentions in 24h window
• Default to 100 results per API call (same cost, more data)
• Pagination respects budget mode (guarded=warn, relaxed/unlimited=auto)

v2.0.3 — Max results per API call

• All scripts now default to 100 results per API request (was 10-20)
• Same API cost, 5-10x more data per call
• Briefing, timeline, and mentions all optimised

v2.0.2 — SETUP.md repo URL fix

• Fixed clone URL in SETUP.md to point to x-smart-read after repo rename
• No code changes

v2.0.1 — Long-form post support (note_tweet)

• Fixed truncation of long-form posts (>280 chars)
• Added note_tweet field support in x_read.py
• Tested on Vitalik's ~1,500 word prediction markets post

v2.0.0 — Read Any Tweet, Bookmarks, Briefings

What's New

New scripts:

• x_read.py — paste any tweet URL or ID, get full content. Thread mode reconstructs entire conversations automatically.
• x_bookmarks.py — list, add, remove bookmarks from CLI
• x_briefing.py — one command morning briefing: posts + mentions + profile + follower delta (~$0.02)
• x_common.py — shared module, all scripts refactored for cleaner codebase

New features:

• Budget modes: guarded (default — warn + block), relaxed (warn only), unlimited (no limits)
• --no-budget flag on all scripts to skip budget checks entirely
• Consistent error handling (401/402/403/429 all get clear messages)
• CONTRIBUTING.md for contributors

Updated docs:

• README restructured with commands table, FAQ, cost scaling section, roadmap
• SETUP.md expanded with budget mode troubleshooting
• AGENTS.md full machine-readable command reference
• x-api-quickref.md expanded with batch lookup, search, bookmarks endpoints

Removed:

• composio-x-research.md (obsolete)

---

Official API only. No scraping, no suspension risk. ~$1-2/mo.

v1.0.0 — Initial Release

X Personal Analytics for AI Agents

First release. Official X API v2, no scraping.

Scripts:

• x_timeline.py — your recent posts with full engagement metrics
• x_mentions.py — who's replying/quoting you + their follower count
• x_user.py — profile lookup + follower tracking
• x_setup.py — guided setup wizard

Features:

• Persistent local store (tweets fetched once, stored forever)
• Incremental fetching via since_id
• Daily budget guards (lite/standard/intense tiers)
• Cost optimized: ~$1-2/month for daily use
• Works with OpenClaw, Claude Code, Codex, or any agent that reads SKILL.md