Key Commands

# Browse
yarn-threads home                        # Home feed
yarn-threads likes                       # Your liked posts
yarn-threads saved                       # Your saved/bookmarked posts

# Read
yarn-threads read <url-or-code>          # Single post
yarn-threads thread <url-or-code>        # Post + all replies
yarn-threads replies <url-or-code>       # Replies only

# Profiles
yarn-threads about <handle>              # User profile info
yarn-threads user-posts <handle>         # User's posts
yarn-threads followers <handle>          # User's followers
yarn-threads following <handle>          # Who user follows

# Search
yarn-threads search <query>              # Search users

# Post / Engage
yarn-threads post "text"                 # Create new post
yarn-threads reply <url-or-code> "text"  # Reply to a post
yarn-threads quote <url-or-code> "text"  # Quote a post

Output Flags

--json — structured JSON output (use for parsing media URLs, metadata)
--plain — stable plain text, no emoji/color (good for piping)
--json-full — includes raw API response (debugging)

Pagination

Feed/list commands support:

--all — fetch all pages
--max-pages <n> — limit pages
--cursor <cursor> — start from a specific page cursor

Media

When using --json, posts include CDN URLs for images and videos in the media fields. Analyze these with the image tool for visual context.

Examples

# Get last 2 pages of likes as JSON
yarn-threads likes --max-pages 2 --json

# Read a specific thread
yarn-threads read https://www.threads.net/@user/post/abc123

# Post with restricted replies
yarn-threads post "Hello Threads" --reply-control accounts_you_follow

# Get a profile
yarn-threads about zuck

See references/commands.md for full flag reference per command.

yarn-threads

yarn-threads

Installation

Auth