Profile My skills Saved Collections Edit profile Submit a skill

Spool

Threads CLI - Post, read, and search on Meta's Threads from the terminal.

zizi-cat 76bafa4 1.2 KB Updated
Coding & Dev Tools

File contents

spool

Use spool to post, read, and search on Meta's Threads.

Setup

  1. Create a Meta app at https://developers.facebook.com/apps/
  2. Add the Threads API product
  3. Set OAuth redirect URI: http://localhost:8899/callback
  4. Run spool login and enter your Client ID & Secret

Quick Commands

# Auth
spool login
spool logout

# Profile
spool whoami

# Post
spool post "Hello from the terminal! 🧵"
spool post "Check this!" --image https://example.com/img.jpg

# Reply
spool reply <id-or-url> "Nice thread!"

# Read
spool read <id-or-url>

# List your posts
spool posts
spool posts -n 20

# Search
spool search "AI"
spool search "#coding" --tag

Required Scopes

  • threads_basic - Profile access
  • threads_content_publish - Create posts
  • threads_manage_replies - Manage replies
  • threads_read_replies - Read replies
  • threads_manage_insights - Analytics

Environment Variables

export THREADS_CLIENT_ID="your-client-id"
export THREADS_CLIENT_SECRET="your-client-secret"

Tips

  • Confirm with user before posting
  • Post IDs can be extracted from Threads URLs
  • Max 500 characters per post

zizi-cat/spool/tree/main/skill commit 76bafa4ce9

Browse category

Frequently asked questions

npx skillmds add zizi-cat/spool