---
name: nitter-feed
description: Monitor Twitter/X feeds via self-hosted Nitter RSS with background polling.
metadata: { "minion": { "emoji": "🐦", "requires": { "plugins": ["nitter"] } } }
---

# Nitter Feed Monitor

Monitor Twitter/X accounts via RSS from a self-hosted Nitter instance.

When to use

- When asked to follow, monitor, track, or check Twitter/X accounts or feeds.

Quick start

- Subscribe to a feed: `nitter_feed` with action `subscribe` and username
- Fetch latest tweets: `nitter_feed` with action `fetch` and username
- List all subscriptions: `nitter_feed` with action `list`

Actions

- **Subscribe**: `nitter_feed { action: "subscribe", username: "elonmusk" }` — start polling a user's feed.
- **Fetch latest**: `nitter_feed { action: "fetch", username: "elonmusk" }` — get recent tweets from a user.
- **List feeds**: `nitter_feed { action: "list" }` — show all active subscriptions.
- **Check status**: `nitter_feed { action: "status" }` — check Nitter instance health and polling state.
- **Unsubscribe**: `nitter_feed { action: "unsubscribe", username: "elonmusk" }` — stop polling a user's feed.

Delivery behavior

New tweets from subscribed feeds are injected into the active session context. If no session is active, updates are delivered to the agent's configured default channel as a fallback.

Not for

- Posting or replying to tweets (read-only via RSS).
- Real-time streaming (polling interval depends on Nitter cache config, typically 10 min).
- Accessing private or protected accounts (Nitter only surfaces public tweets).
