bird-twitter

What This Skill Does

The bird-twitter skill provides a high-performance, terminal-based interface for interacting with the X (formerly Twitter) platform. By leveraging a fast GraphQL-based CLI wrapper, this skill allows users to perform nearly all core social activities directly from their terminal. Whether you need to post updates, monitor your timeline, engage with threads, or perform advanced searches, bird-twitter streamlines the process by bypassing the heavy web interface, offering a lightweight alternative for power users and developers. It is particularly useful for automated reporting, social listening, and maintaining a presence on the platform without requiring a browser window.

Installation

To install this skill, use the ClawHub command: clawhub install openclaw/skills/skills/chuhuilove/bird-twitter. Once installed, you must authenticate the agent by setting the necessary environment variables: AUTH_TOKEN and CT0. These are extracted from your browser's cookie storage after logging into X. You can place these in your shell profile or environment configuration. Ensure you have the bird CLI binary configured correctly in your system path to ensure the skill operates as expected.

Use Cases

• Automated Social Updates: Use the agent to push status updates from your CI/CD pipelines or automated monitoring scripts.
• Content Aggregation: Programmatically pull your home timeline, mentions, or specific user tweets to analyze trends or gather data for research.
• Streamlined Engagement: Quickly reply to important mentions or search for specific industry-related discussions without leaving your development environment.
• Data Export: Utilize the --json or --json-full output flags to pipe raw X data into other processing tools like jq or data analysis pipelines.

Example Prompts

1. "Post a new tweet saying 'Just launched my new open source project! Check it out at link.com #opensource'"
2. "Get the latest mentions from my feed and show me if there are any urgent questions I need to reply to."
3. "Search for the latest tweets about 'AI agents' and provide me with a summary of the top trending posts."

Tips & Limitations

• Rate Limiting: Because this tool uses a GraphQL client, be mindful of X's API rate limits. Excessive automated requests may trigger temporary account blocks.
• Authentication: Keep your cookies secure. Since the skill uses your browser credentials, never share your AUTH_TOKEN or CT0 with untrusted parties.
• Format Consistency: Always prefer the --json flag when building scripts; it provides structured data that is significantly easier to parse than the default formatted text output. Use --plain if you are outputting to logs where terminal color codes might cause issues.