understudy

Use Xquik REST and MCP APIs for X data workflows: search public posts, inspect users, export datasets, download media, monitor accounts or keywords, and send webhook events. Use when the user needs X data from Xquik rather than account-scoped X API actions through xurl.

Collect the baseline context bundle for the selected target.

Compose the final draft summary video from the generated assets and brief.

Goal-driven worker for exploring an unfamiliar target.

Prepare the delivery preview payload from the generated assets.

Render polished cover and summary-card image assets for the brief package.

Turn context findings into a summary packet and short brief.

Single-stage acceptance playbook for the baseline context phase.

Hand-written end-to-end playbook for a reusable target brief workflow.

Research current topics with multiple sources and produce a structured brief, comparison, recommendation, or fact-check. Use when the user asks for investigation, market/product landscape scans, option evaluation, due diligence, source-backed validation, or a research report. Do not use for summarizing a single provided URL/document, or for GitHub issue/PR operations.

Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.

Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks Understudy to add a note, list notes, search notes, or manage note folders.

Manage Apple Reminders via remindctl CLI (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.

Create, search, and manage Bear notes via grizzly CLI.

Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.

BluOS CLI (blu) for discovery, playback, grouping, and volume.

Capture frames or clips from RTSP/ONVIF cameras.

Delegate coding tasks to Codex, Claude Code, or Pi agents via background process. Use when: (1) building/creating new features or apps, (2) reviewing PRs (spawn in temp dir), (3) refactoring large codebases, (4) iterative coding that needs file exploration. NOT for: simple one-liner fixes (just edit), reading code (use read tool), thread-bound ACP harness requests in chat (for example spawn/run Codex or Claude Code in a Discord thread; use sessions_spawn with runtime:"acp"), or any work in a live Understudy deployment/workspace (never spawn agents there). Claude Code: use --print --permission-mode bypassPermissions (no PTY). Codex/Pi/OpenCode: pty:true required.

Discord messaging via `message_send` (channel=discord). Use for outbound sends, replies, edits, reactions, deletes, and attachment sends on Discord.

Control Eight Sleep pods (status, temperature, alarms, schedules).

Gemini CLI for one-shot Q&A, summaries, and generation.

Fetch GitHub issues, spawn sub-agents to implement fixes and open PRs, then monitor and address PR review comments. Usage: /gh-issues [owner/repo] [--label bug] [--limit 5] [--milestone v1.0] [--assignee @me] [--fork user/repo] [--watch] [--interval 5] [--reviews-only] [--cron] [--dry-run] [--model glm-5] [--notify-channel -1002381931352]

Search GIF providers with CLI/TUI, download results, and extract stills/sheets.

GitHub operations via `gh` CLI: issues, PRs, CI runs, code review, API queries. Use when: (1) checking PR status or CI, (2) creating/commenting on issues, (3) listing/filtering PRs or issues, (4) viewing run logs. NOT for: complex web UI interactions requiring manual browser flows (use browser tooling when available), bulk operations across many repos (script with gh api), or when gh auth is not configured.

Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

Query Google Places API (New) via the goplaces CLI for text search, place details, resolve, and reviews. Use for human-friendly place lookup or JSON output for scripts.

Host security hardening and risk-tolerance guidance for Understudy deployments. Use when a user asks for security audits, firewall/SSH/update hardening, exposure review, or recurring checks on a machine running Understudy.

CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).

iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app.

Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.

Use CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.

Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro).

Edit PDFs with natural-language instructions using the nano-pdf CLI.

Notion API for creating and managing pages, databases, and blocks.

Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.

Batch-generate images via OpenAI Images API. Random prompt sampler + `index.html` gallery.

Transcribe audio via OpenAI Audio Transcriptions API (Whisper).

Local speech-to-text with the Whisper CLI (no API key).

Control Philips Hue lights and scenes via the OpenHue CLI.

Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).