bird-dm

✓Verified·Scanned 2/18/2026

This skill is a CLI add-on that reads X/Twitter DMs using browser cookies and the bird credential helper. It accepts --auth-token/--ct0 or uses resolveCredentials to access auth_token/ct0 cookies and calls https://x.com/i/api/1.1/dm/inbox_initial_state.json and https://x.com/i/api/1.1/dm/conversation.

from clawhub.ai·v229706d·41.7 KB·0 installs

Scanned from 1.0.2 at 229706d · Transparency log ↗

$ vett add clawhub.ai/tolibear/bird-dm

Bird DM 💬

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

Install

npm install -g bird-dm

Requires:

Node.js 22+
bird for auth verification

Usage

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

# Read a specific conversation
bird-dm read <conversation-id>
bird-dm read <id> -n 100   # more messages
bird-dm read <id> --json   # JSON output

Auth

Uses the same browser cookie auth as bird. Must be logged into X/Twitter in Chrome/Firefox/Safari.

# Verify your session
bird check

# Or pass cookies directly
bird-dm inbox --auth-token <token> --ct0 <token>

For AI Agents

Available as a skill on ClawHub:

clawdhub install bird-dm

API

Can also be used as a library:

import { fetchDMInbox, parseInbox } from 'bird-dm';
import { resolveCredentials } from '@steipete/bird';

const { cookies } = await resolveCredentials({ cookieSources: ['chrome'] });
const data = await fetchDMInbox(cookies);
const conversations = parseInbox(data);

License

MIT