Tools Reference

Tools Reference

CLI tools available on Peter's machines. Use these for agentic tasks.

bird 🐦

Twitter/X CLI for posting, replying, reading tweets.

**Location**: `~/Projects/bird/bird`

**Commands**:

bird tweet ""                    # Post a tweet
bird reply  ""  # Reply to a tweet
bird read             # Fetch tweet content
bird replies          # List replies to a tweet
bird thread           # Show full conversation thread
bird search "" [-n count]       # Search tweets
bird mentions [-n count]               # Find tweets mentioning @clawdbot
bird whoami                            # Show logged-in account
bird check                             # Show credential sources

**Auth**: Uses Firefox cookies by default. Pass `--firefox-profile ` to switch.

---

sonoscli 🔊

Control Sonos speakers over local network (UPnP/SOAP).

**Location**: `~/Projects/sonoscli/bin/sonos`

**Commands**:

sonos discover                         # Find speakers on network
sonos status --name "Room"             # Current playback status
sonos play/pause/stop --name "Room"    # Playback control
sonos next/prev --name "Room"          # Track navigation
sonos volume get/set --name "Room" 25  # Volume control
sonos mute get/toggle --name "Room"    # Mute control

# Grouping
sonos group status                     # Show current groups
sonos group join --name "A" --to "B"   # Join A into B's group
sonos group unjoin --name "Room"       # Make standalone
sonos group party --to "Room"          # Join all to one group

# Spotify (via SMAPI)
sonos smapi search --service "Spotify" --category tracks "query"
sonos open --name "Room" spotify:track:

**Known issues**:

• SSDP multicast may fail; use --ip as fallback
• Default HTTP keep-alives can cause timeouts (fix pending: DisableKeepAlives)

---

peekaboo 👀

Screenshot, screen inspection, and click automation.

**Location**: `~/Projects/Peekaboo`

**Commands**:

peekaboo capture                       # Take screenshot
peekaboo see                           # Describe what's on screen (OCR)
peekaboo click                         # Click at coordinates
peekaboo list                          # List windows/apps
peekaboo tools                         # Show available tools
peekaboo permissions status            # Check TCC permissions

**Requirements**: Screen Recording + Accessibility permissions.

**Docs**: `~/Projects/Peekaboo/docs/commands/`

---

sweetistics 📊

Twitter/X analytics desktop app (Tauri).

**Location**: `~/Projects/sweetistics`

Use for deeper Twitter data analysis beyond what `bird` provides.

---

clawdis 📡

WhatsApp/Telegram messaging gateway and agent interface.

**Location**: `~/Projects/clawdis`

**Commands**:

clawdis login                          # Link WhatsApp via QR
clawdis send --to  --message "text"  # Send message
clawdis agent