Use this repo when you need Threads workflows from the terminal.
- Unofficial read commands need your own Threads/Instagram session cookies.
- Official post commands need
THREADS_ACCESS_TOKENandTHREADS_USER_ID, or~/.config/threads/oauth.json.
threads-cli auth-status
threads-cli read feed --limit 20 --json
threads-cli read feed --user-id 12345 --limit 20 --json
threads-cli read thread https://www.threads.net/@aiden/post/ABC123 --json
threads-cli post text --text "Hello from threads-cli" --dry-run --json
threads-cli post text --text "Hello from threads-cli" --json
threads-cli post media --text "Hello with image" --media-url "https://example.com/image.jpg" --json- Prefer
--jsonwhen another tool or script will consume the output. - Treat
readoutput as unofficial andpostcommands as official publishing API calls. - Run
auth-statusbefore read extraction when session health is uncertain. - Run
--dry-run --jsonbefore live publishing generated content. - Do not log cookies or OAuth tokens.