IdleHands

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 ~/clawd workspace (never spawn agents here). Requires a bash tool that supports pty:true.

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

Route plain-language requests for Pi, Claude Code, Codex, OpenCode, Gemini CLI, or ACP harness work into either IdleHands ACP runtime sessions or direct acpx-driven sessions ("telephone game" flow).

OpenProse VM skill pack. Activate on any `prose` command, .prose files, or OpenProse mentions; orchestrates multi-agent workflows.

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 IdleHands 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.

Use when you need to send or manage iMessages via BlueBubbles (recommended iMessage integration). Calls go through the generic message tool with channel="bluebubbles".

Capture frames or clips from RTSP/ONVIF cameras.

Use the ClawHub CLI to search, install, update, and publish agent skills from clawhub.com. Use when you need to fetch new skills on the fly, sync installed skills to latest or a specific version, or publish new/updated skill folders with the npm-installed clawhub CLI.

Discord ops via the message tool (channel=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 configuration for IdleHands deployments. Use when a user asks for security audits, firewall/SSH/update hardening, risk posture, exposure review, IdleHands cron scheduling for periodic checks, or version status checks on a machine running IdleHands (laptop, workstation, Pi, VPS).

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.

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).

Foodora-only CLI for checking past orders and active order status (Deliveroo WIP).

Capture and automate macOS UI with the Peekaboo CLI.

ElevenLabs text-to-speech with mac-style say UX.

Search and analyze your own session logs (older/parent conversations) using jq.

Local text-to-speech via sherpa-onnx (offline, no cloud)

Use when you need to control Slack from IdleHands via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.