tolibear

bird-dm

0
0
# Install this skill:
npx skills add tolibear/bird-dm

Or install specific skill: npx add-skill https://github.com/tolibear/bird-dm

# Description

An add-on to the Bird skill that lets your agent check its X/Twitter DM inbox. Use when the user asks to check DMs, read Twitter direct messages, list DM conversations, or monitor their X inbox.

# SKILL.md


name: bird-dm
description: An add-on to the Bird skill that lets your agent check its X/Twitter DM inbox. Use when the user asks to check DMs, read Twitter direct messages, list DM conversations, or monitor their X inbox.
metadata:
openclaw:
emoji: "πŸ’¬"
requires:
bins: ["bird", "bun"]


Bird DM

DM add-on for bird β€” uses bird's auth, adds DM commands.

Install

npm install -g bird-dm

Commands

bird-dm inbox              # List DM conversations
bird-dm inbox -n 50        # More conversations  
bird-dm inbox --json       # JSON output

bird-dm read <conv-id>     # Read messages from a conversation
bird-dm read <id> -n 100   # More messages
bird-dm read <id> --json   # JSON output

Auth Options

Uses bird's resolveCredentials() β€” same auth methods as bird:

# Browser extraction (default)
bird-dm inbox --cookie-source chrome

# Direct tokens
bird-dm inbox --auth-token xxx --ct0 yyy

Verify session: bird check

Typical Workflow

# 1. List conversations
bird-dm inbox

# 2. Find conversation ID from output (e.g., 123456789-987654321)
# 3. Read that conversation
bird-dm read 123456789-987654321

# README.md

Bird DM πŸ’¬

DM add-on for bird - read your X/Twitter direct messages.

Install

npm install -g bird-dm

Requires bun (for browser cookie extraction) and bird for auth.

Usage

bird-dm inbox              # List conversations
bird-dm inbox -n 50        # More conversations
bird-dm inbox --json       # JSON output

bird-dm read <conv-id>     # Read messages
bird-dm read <id> -n 100   # More messages
bird-dm read <id> --json   # JSON output

Auth

Uses bird's credential resolution β€” supports all the same auth methods:

  1. Browser extraction (default): Reads cookies from Chrome/Firefox/Safari
    bash bird-dm inbox --cookie-source chrome

  2. Direct tokens: Pass auth tokens directly
    bash bird-dm inbox --auth-token xxx --ct0 yyy

  3. Config file: Stored in ~/.config/bird/config.json5

Verify your session with:

bird check

License

MIT

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.