---
name: x-monitor
description: "Monitor X/Twitter accounts and topics with AI-enriched Discord alerts. Cron-powered, fully agentic."
version: 1.0.0
emoji: "🐦"
metadata:
  openclaw:
    requires:
      env:
        - AUTH_TOKEN
        - CT0
        - DISCORD_BOT_TOKEN
        - DISCORD_ACCOUNT_CHANNEL_ID
        - DISCORD_RESEARCH_CHANNEL_ID
      bins:
        - bird
      anyBins:
        - google-chrome
        - chromium
    primaryEnv: AUTH_TOKEN
    os: ["macos", "linux"]
    install:
      - kind: brew
        formula: agent-reach
        bins: [bird]
        label: "Install bird CLI (agent-reach)"
---

# X Monitor + X Research

> **For the full agentic pipeline runbook** (cron jobs, error handling, self-repair), read `PIPELINE.md`.
> **For setup instructions**, see `README.md` or run `node setup.js`.

Handle Discord slash commands for X account monitoring (`/x-monitor`) and topic research (`/x-research`).

---

## /x-monitor Commands

| Action | Command |
|--------|---------|
| `add <username>` | Add an X account to monitoring |
| `remove <username>` | Remove an X account from monitoring |
| `list` | List all monitored accounts |
| `status` | Show monitoring status |
| `mute <username>` | Mute alerts for an account |

```bash
node src/cli/commands.js add <username>
node src/cli/commands.js remove <username>
node src/cli/commands.js list
node src/cli/commands.js status
```

### Response Templates

**add success:** `✅ Now monitoring @<username>`
**add error:** `❌ Error: <message>`
**remove success:** `✅ Removed @<username> from monitoring`
**list:**
```
📋 Monitoring (N accounts):
@account1, @account2, @account3
```
**status:**
```
🐦 X Monitor: Active
Monitoring N accounts
```

---

## /x-research Commands

| Action | Command |
|--------|---------|
| `add <topic>` | Start tracking a topic |
| `remove <topic>` | Stop tracking a topic |
| `list` | List active topics |
| `list-all` | List all topics including paused |
| `status` | Show topic counts (active/paused/total) |
| `pause <topic>` | Pause alerts for a topic |
| `resume <topic>` | Resume alerts for a topic |

```bash
node src/cli/topic-commands.js add "<topic>"
node src/cli/topic-commands.js remove "<topic>"
node src/cli/topic-commands.js list
node src/cli/topic-commands.js list-all
node src/cli/topic-commands.js status
node src/cli/topic-commands.js pause "<topic>"
node src/cli/topic-commands.js resume "<topic>"
```

### Response Templates

**add success:** `✅ Now tracking topic: "<topic>"`
**remove success:** `✅ Removed topic: "<topic>"`
**pause success:** `⏸ Paused topic: "<topic>"`
**resume success:** `▶️ Resumed topic: "<topic>"`
**list:**
```
🔍 Tracking N topics:
• topic one
• topic two
```
**status:**
```
🔍 X Research: Active
N active topics, N paused
```

---

## Implementation Notes

- Parse arguments to determine action, execute CLI command, send result back via `message` tool
- Use the channel from the interaction context
- Quote multi-word topics when passing to topic-commands.js
- Use ephemeral responses for confirmations where appropriate