bird

The bird skill serves as a specialized command-line utility for OpenWhale, enabling seamless interaction with the X/Twitter platform without requiring complex official API keys. By leveraging GraphQL and existing browser authentication cookies, this tool allows users and autonomous agents to perform a wide range of social operations directly from their terminal or within an AI orchestration workflow. It is designed for power users, developers, and automation engineers who need to bridge the gap between AI-driven content generation and social media distribution, ensuring that interaction with timelines, bookmarks, and engagement features remains fast and private.

• Perform granular reads, including single tweets, full conversation threads, and specific reply chains.

• Execute complex searches across the platform with pagination support to collect comprehensive datasets.

• Automate social engagement such as following, unfollowing, posting original tweets, and replying to existing threads with media support (images and videos).

• Retrieve timelines, including home feeds, user profiles, mentions, lists, and curated AI-news.

• Manage bookmarks and likes with full page navigation and cursor-based resume capabilities for large history extraction.

• Retrieve social graph data, including follower and following lists for any accessible user account.

• Authentication is handled via cookie-based sessions, requiring users to export auth tokens (ct0) or point the tool to specific browser profiles like Chrome, Arc, or Brave.

• The tool supports JSON output, which is ideal for piping data into other CLI tools or processing within Python/Node.js scripts.

• Users must exercise caution regarding rate limits; the tool provides options for delays between pagination requests to ensure stability.

• Global configuration is supported through standard .json5 config files or environment variables, facilitating easy integration into automated CI/CD or agent scheduling environments.

• The tool is natively compatible with the OpenWhale agent swarm architecture, allowing agents to use 'bird' as a core interaction tool for social media management and real-time monitoring.