# X User Timeline

> Get recent tweets from an X/Twitter user. Use when user asks "what has @username posted", "recent tweets from", "user's X posts", "show timeline for", "what is @user saying". Requires X_BEARER_TOKEN.

- Skill: `b-open-io-prompts/x-user-timeline` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add b-open-io-prompts/x-user-timeline`
- Raw SKILL.md: https://api.skillmd.com/api/skills/b-open-io-prompts/x-user-timeline/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: b-open-io (https://skillmd.com/u/b-open-io-prompts)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/b-open-io-prompts/x-user-timeline

---


# X User Timeline

Get recent tweets from a specific user.

## Setup

```bash
export X_BEARER_TOKEN="your-token"  # https://developer.x.com/en/portal/dashboard
```

## Usage

```bash
${CLAUDE_SKILL_DIR}/scripts/timeline.sh <username> [max_results]
```

## Examples

```bash
# Get 10 recent tweets (default)
${CLAUDE_SKILL_DIR}/scripts/timeline.sh kurtwuckertjr

# Get 25 tweets
${CLAUDE_SKILL_DIR}/scripts/timeline.sh kurtwuckertjr 25
```

## Response Fields

- `text` - Tweet content
- `created_at` - Post timestamp
- `public_metrics` - Likes, retweets, replies, views
- `author` - User info (expanded)

## Pricing and Rate Limits

X API access is pay-per-use. Read the endpoint's rate-limit response headers and
consult the current X API pricing and rate-limit documentation instead of
assuming a fixed free-tier quota.

## References

- https://docs.x.com/llms.txt
- https://developer.x.com/en/docs/x-api/tweets/timelines