threads-cli

name	threads-cli
description	Procedural skill for interacting with Meta's Threads platform via threads-cli.

threads-cli Skill

A procedural skill for interacting with Meta's Threads platform via the threads-cli tool.

Description

This skill provides instructions for using the threads-cli command-line interface to manage Threads posts, threads, profiles, and insights. It is highly effective for automation within Hermes Agent.

Common Workflows

1. Authentication

Before using any commands, ensure you are authenticated.

• Check status: threads-cli auth status
• Login: threads-cli auth login (requires interactive OAuth)
• Setup CA for easier login: threads-cli setup

2. Publishing Posts and Threads

threads-cli uses files to define content.

Single Post:

1. Create a text file (e.g., post.txt) with your content.
2. Publish: threads-cli publish --yes post.txt

Multi-post Thread:

1. Create a text file (e.g., thread.txt).
2. Separate each post with --- on a new line.
3. Publish: threads-cli thread --yes thread.txt

Scheduling a Post:

1. Create a draft file.
2. Schedule: threads-cli schedule draft.txt "YYYY-MM-DD HH:MM:SS"

3. Managing Drafts

• List drafts: threads-cli draft list
• Create new draft: threads-cli draft new
• Delete draft: threads-cli draft delete <ID>

4. Reading and Inspecting Content

• List recent posts: threads-cli posts list
• Get specific post details: threads-cli posts get <ID>
• Fetch replies to a post: threads-cli posts replies <ID>
• View profile info: threads-cli profile
• View post insights: threads-cli insights <POST_ID>

Pitfalls & Tips

• File Formatting: When creating threads, ensure the --- separator is on its own line.
• Dry Run: Always use --dry-run first if you are unsure of the file format or content to avoid accidental publishing.
• Automation: This tool is perfect for Hermes Agent to implement "Post-to-GitHub" or "News-to-Threads" automation.
• Timezone: When scheduling, ensure the datetime format matches YYYY-MM-DD HH:MM:SS.

Verification Steps

• After publishing, use threads-cli posts list to verify the new post appears in the history.
• Use threads-cli auth status to confirm the session is still valid.