Skip to content
Skill

xradio

by mikesmullin

AI Summary

xradio is a CLI tool for caching and reading Twitter/X posts offline with video playback support. It's useful for developers and power users who want to manage their Twitter feed locally without constant internet access.

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "xradio" skill in my project.

Please run this command in my terminal:
# Install skill into the correct directory
mkdir -p .claude/skills/xradio && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/xradio/SKILL.md "https://raw.githubusercontent.com/mikesmullin/xradio/main/SKILL.md"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

Description

CLI tool for pulling, caching, and reading Twitter/X posts offline

Prerequisites

• Browser server must be running for pull command: browser server start • Must be logged into Twitter/X in the browser session • yt-dlp and mpv for video playback

xradio

A command-line tool for managing a local cache of Twitter/X posts. Pull tweets from your feed, read them offline, track read/unread status, and play videos.

Pull Tweets from Feed

`bash xradio pull --limit <n> ` Fetches tweets from your Twitter home feed and saves them to local storage. • --limit <n>: Number of tweets to pull (default: 10) • Automatically scrolls to load more if needed • Never overwrites existing cached tweets - skips duplicates • Requires browser server to be running and logged into Twitter Example: `bash xradio pull --limit 20 ` Output: ` 📡 Pulling up to 20 new tweets from feed... 🌐 Browser connected: https://x.com/home 🔄 Refreshing feed... scroll 1: +8 new, 2 cached (8/20 total new) scroll 2: +6 new, 4 cached (14/20 total new) scroll 3: +6 new, 3 cached (20/20 total new) ✅ [a1b2c3d] User Name: Tweet text preview... ✅ [e4f5g6h] Another User: More tweet content here... 📦 Done! Saved 20 new tweets. `

List Cached Tweets

`bash xradio list # Show unread tweets only xradio list -A # Show all tweets (including read) xradio list --all # Same as -A ` Lists tweets in the offline cache. • By default, only shows unread tweets • Use -A or --all to include read tweets • Shows media indicators: 🎬 (video), 🖼️ (image) • Shows ✓ for read tweets (when using --all) Output: ` 📚 4 unread tweets in cache: a1b2c3d🎬🖼️ Man, Crimson Desert looks like the kind of game that would make me disappear... e4f5g6h🖼️ Breaking: New development in the ongoing situation as officials announce... Use 'xradio read <id>' to view a tweet, 'xradio mark <id>' to mark as read. `

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 3mo ago
Stale
AdoptionUnder 100 stars
0 ★ · Niche
DocsMissing or thin
Undocumented

GitHub Signals

Issues0
Updated3mo ago
View on GitHub
MIT License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code