loudmouth-ai 0.1.0 → 0.2.0

package/skills/slack/SKILL.md

@@ -1,144 +0,0 @@
----
-name: slack
-description: Use when you need to control Slack from Clawdbot via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.
-metadata: {"clawdbot":{"emoji":"💬","requires":{"config":["channels.slack"]}}}
----
-
-# Slack Actions
-
-## Overview
-
-Use `slack` to react, manage pins, send/edit/delete messages, and fetch member info. The tool uses the bot token configured for Clawdbot.
-
-## Inputs to collect
-
-- `channelId` and `messageId` (Slack message timestamp, e.g. `1712023032.1234`).
-- For reactions, an `emoji` (Unicode or `:name:`).
-- For message sends, a `to` target (`channel:<id>` or `user:<id>`) and `content`.
-
-Message context lines include `slack message id` and `channel` fields you can reuse directly.
-
-## Actions
-
-### Action groups
-
-| Action group | Default | Notes |
-| --- | --- | --- |
-| reactions | enabled | React + list reactions |
-| messages | enabled | Read/send/edit/delete |
-| pins | enabled | Pin/unpin/list |
-| memberInfo | enabled | Member info |
-| emojiList | enabled | Custom emoji list |
-
-### React to a message
-
-```json
-{
-  "action": "react",
-  "channelId": "C123",
-  "messageId": "1712023032.1234",
-  "emoji": "✅"
-}
-```
-
-### List reactions
-
-```json
-{
-  "action": "reactions",
-  "channelId": "C123",
-  "messageId": "1712023032.1234"
-}
-```
-
-### Send a message
-
-```json
-{
-  "action": "sendMessage",
-  "to": "channel:C123",
-  "content": "Hello from Clawdbot"
-}
-```
-
-### Edit a message
-
-```json
-{
-  "action": "editMessage",
-  "channelId": "C123",
-  "messageId": "1712023032.1234",
-  "content": "Updated text"
-}
-```
-
-### Delete a message
-
-```json
-{
-  "action": "deleteMessage",
-  "channelId": "C123",
-  "messageId": "1712023032.1234"
-}
-```
-
-### Read recent messages
-
-```json
-{
-  "action": "readMessages",
-  "channelId": "C123",
-  "limit": 20
-}
-```
-
-### Pin a message
-
-```json
-{
-  "action": "pinMessage",
-  "channelId": "C123",
-  "messageId": "1712023032.1234"
-}
-```
-
-### Unpin a message
-
-```json
-{
-  "action": "unpinMessage",
-  "channelId": "C123",
-  "messageId": "1712023032.1234"
-}
-```
-
-### List pinned items
-
-```json
-{
-  "action": "listPins",
-  "channelId": "C123"
-}
-```
-
-### Member info
-
-```json
-{
-  "action": "memberInfo",
-  "userId": "U123"
-}
-```
-
-### Emoji list
-
-```json
-{
-  "action": "emojiList"
-}
-```
-
-## Ideas to try
-
-- React with ✅ to mark completed tasks.
-- Pin key decisions or weekly status updates.

package/skills/songsee/SKILL.md

@@ -1,29 +0,0 @@
----
-name: songsee
-description: Generate spectrograms and feature-panel visualizations from audio with the songsee CLI.
-homepage: https://github.com/steipete/songsee
-metadata: {"clawdbot":{"emoji":"🌊","requires":{"bins":["songsee"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/songsee","bins":["songsee"],"label":"Install songsee (brew)"}]}}
----
-
-# songsee
-
-Generate spectrograms + feature panels from audio.
-
-Quick start
-- Spectrogram: `songsee track.mp3`
-- Multi-panel: `songsee track.mp3 --viz spectrogram,mel,chroma,hpss,selfsim,loudness,tempogram,mfcc,flux`
-- Time slice: `songsee track.mp3 --start 12.5 --duration 8 -o slice.jpg`
-- Stdin: `cat track.mp3 | songsee - --format png -o out.png`
-
-Common flags
-- `--viz` list (repeatable or comma-separated)
-- `--style` palette (classic, magma, inferno, viridis, gray)
-- `--width` / `--height` output size
-- `--window` / `--hop` FFT settings
-- `--min-freq` / `--max-freq` frequency range
-- `--start` / `--duration` time slice
-- `--format` jpg|png
-
-Notes
-- WAV/MP3 decode native; other formats use ffmpeg if available.
-- Multiple `--viz` renders a grid.

package/skills/sonoscli/SKILL.md

@@ -1,26 +0,0 @@
----
-name: sonoscli
-description: Control Sonos speakers (discover/status/play/volume/group).
-homepage: https://sonoscli.sh
-metadata: {"clawdbot":{"emoji":"🔊","requires":{"bins":["sonos"]},"install":[{"id":"go","kind":"go","module":"github.com/steipete/sonoscli/cmd/sonos@latest","bins":["sonos"],"label":"Install sonoscli (go)"}]}}
----
-
-# Sonos CLI
-
-Use `sonos` to control Sonos speakers on the local network.
-
-Quick start
-- `sonos discover`
-- `sonos status --name "Kitchen"`
-- `sonos play|pause|stop --name "Kitchen"`
-- `sonos volume set 15 --name "Kitchen"`
-
-Common tasks
-- Grouping: `sonos group status|join|unjoin|party|solo`
-- Favorites: `sonos favorites list|open`
-- Queue: `sonos queue list|play|clear`
-- Spotify search (via SMAPI): `sonos smapi search --service "Spotify" --category tracks "query"`
-
-Notes
-- If SSDP fails, specify `--ip <speaker-ip>`.
-- Spotify Web API search is optional and requires `SPOTIFY_CLIENT_ID/SECRET`.

package/skills/spotify-player/SKILL.md

@@ -1,34 +0,0 @@
----
-name: spotify-player
-description: Terminal Spotify playback/search via spogo (preferred) or spotify_player.
-homepage: https://www.spotify.com
-metadata: {"clawdbot":{"emoji":"🎵","requires":{"anyBins":["spogo","spotify_player"]},"install":[{"id":"brew","kind":"brew","formula":"spogo","tap":"steipete/tap","bins":["spogo"],"label":"Install spogo (brew)"},{"id":"brew","kind":"brew","formula":"spotify_player","bins":["spotify_player"],"label":"Install spotify_player (brew)"}]}}
----
-
-# spogo / spotify_player
-
-Use `spogo` **(preferred)** for Spotify playback/search. Fall back to `spotify_player` if needed.
-
-Requirements
-- Spotify Premium account.
-- Either `spogo` or `spotify_player` installed.
-
-spogo setup
-- Import cookies: `spogo auth import --browser chrome`
-
-Common CLI commands
-- Search: `spogo search track "query"`
-- Playback: `spogo play|pause|next|prev`
-- Devices: `spogo device list`, `spogo device set "<name|id>"`
-- Status: `spogo status`
-
-spotify_player commands (fallback)
-- Search: `spotify_player search "query"`
-- Playback: `spotify_player playback play|pause|next|previous`
-- Connect device: `spotify_player connect`
-- Like track: `spotify_player like`
-
-Notes
-- Config folder: `~/.config/spotify-player` (e.g., `app.toml`).
-- For Spotify Connect integration, set a user `client_id` in config.
-- TUI shortcuts are available via `?` in the app.

package/skills/summarize/SKILL.md

@@ -1,67 +0,0 @@
----
-name: summarize
-description: Summarize or extract text/transcripts from URLs, podcasts, and local files (great fallback for “transcribe this YouTube/video”).
-homepage: https://summarize.sh
-metadata: {"clawdbot":{"emoji":"🧾","requires":{"bins":["summarize"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/summarize","bins":["summarize"],"label":"Install summarize (brew)"}]}}
----
-
-# Summarize
-
-Fast CLI to summarize URLs, local files, and YouTube links.
-
-## When to use (trigger phrases)
-
-Use this skill immediately when the user asks any of:
-- “use summarize.sh”
-- “what’s this link/video about?”
-- “summarize this URL/article”
-- “transcribe this YouTube/video” (best-effort transcript extraction; no `yt-dlp` needed)
-
-## Quick start
-
-```bash
-summarize "https://example.com" --model google/gemini-3-flash-preview
-summarize "/path/to/file.pdf" --model google/gemini-3-flash-preview
-summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto
-```
-
-## YouTube: summary vs transcript
-
-Best-effort transcript (URLs only):
-
-```bash
-summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto --extract-only
-```
-
-If the user asked for a transcript but it’s huge, return a tight summary first, then ask which section/time range to expand.
-
-## Model + keys
-
-Set the API key for your chosen provider:
-- OpenAI: `OPENAI_API_KEY`
-- Anthropic: `ANTHROPIC_API_KEY`
-- xAI: `XAI_API_KEY`
-- Google: `GEMINI_API_KEY` (aliases: `GOOGLE_GENERATIVE_AI_API_KEY`, `GOOGLE_API_KEY`)
-
-Default model is `google/gemini-3-flash-preview` if none is set.
-
-## Useful flags
-
-- `--length short|medium|long|xl|xxl|<chars>`
-- `--max-output-tokens <count>`
-- `--extract-only` (URLs only)
-- `--json` (machine readable)
-- `--firecrawl auto|off|always` (fallback extraction)
-- `--youtube auto` (Apify fallback if `APIFY_API_TOKEN` set)
-
-## Config
-
-Optional config file: `~/.summarize/config.json`
-
-```json
-{ "model": "openai/gpt-5.2" }
-```
-
-Optional services:
-- `FIRECRAWL_API_KEY` for blocked sites
-- `APIFY_API_TOKEN` for YouTube fallback

package/skills/things-mac/SKILL.md

@@ -1,61 +0,0 @@
----
-name: things-mac
-description: Manage Things 3 via the `things` CLI on macOS (add/update projects+todos via URL scheme; read/search/list from the local Things database). Use when a user asks Clawdbot to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.
-homepage: https://github.com/ossianhempel/things3-cli
-metadata: {"clawdbot":{"emoji":"✅","os":["darwin"],"requires":{"bins":["things"]},"install":[{"id":"go","kind":"go","module":"github.com/ossianhempel/things3-cli/cmd/things@latest","bins":["things"],"label":"Install things3-cli (go)"}]}}
----
-
-# Things 3 CLI
-
-Use `things` to read your local Things database (inbox/today/search/projects/areas/tags) and to add/update todos via the Things URL scheme.
-
-Setup
-- Install (recommended, Apple Silicon): `GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest`
-- If DB reads fail: grant **Full Disk Access** to the calling app (Terminal for manual runs; `Clawdbot.app` for gateway runs).
-- Optional: set `THINGSDB` (or pass `--db`) to point at your `ThingsData-*` folder.
-- Optional: set `THINGS_AUTH_TOKEN` to avoid passing `--auth-token` for update ops.
-
-Read-only (DB)
-- `things inbox --limit 50`
-- `things today`
-- `things upcoming`
-- `things search "query"`
-- `things projects` / `things areas` / `things tags`
-
-Write (URL scheme)
-- Prefer safe preview: `things --dry-run add "Title"`
-- Add: `things add "Title" --notes "..." --when today --deadline 2026-01-02`
-- Bring Things to front: `things --foreground add "Title"`
-
-Examples: add a todo
-- Basic: `things add "Buy milk"`
-- With notes: `things add "Buy milk" --notes "2% + bananas"`
-- Into a project/area: `things add "Book flights" --list "Travel"`
-- Into a project heading: `things add "Pack charger" --list "Travel" --heading "Before"`
-- With tags: `things add "Call dentist" --tags "health,phone"`
-- Checklist: `things add "Trip prep" --checklist-item "Passport" --checklist-item "Tickets"`
-- From STDIN (multi-line => title + notes):
-  - `cat <<'EOF' | things add -`
-  - `Title line`
-  - `Notes line 1`
-  - `Notes line 2`
-  - `EOF`
-
-Examples: modify a todo (needs auth token)
-- First: get the ID (UUID column): `things search "milk" --limit 5`
-- Auth: set `THINGS_AUTH_TOKEN` or pass `--auth-token <TOKEN>`
-- Title: `things update --id <UUID> --auth-token <TOKEN> "New title"`
-- Notes replace: `things update --id <UUID> --auth-token <TOKEN> --notes "New notes"`
-- Notes append/prepend: `things update --id <UUID> --auth-token <TOKEN> --append-notes "..."` / `--prepend-notes "..."`
-- Move lists: `things update --id <UUID> --auth-token <TOKEN> --list "Travel" --heading "Before"`
-- Tags replace/add: `things update --id <UUID> --auth-token <TOKEN> --tags "a,b"` / `things update --id <UUID> --auth-token <TOKEN> --add-tags "a,b"`
-- Complete/cancel (soft-delete-ish): `things update --id <UUID> --auth-token <TOKEN> --completed` / `--canceled`
-- Safe preview: `things --dry-run update --id <UUID> --auth-token <TOKEN> --completed`
-
-Delete a todo?
-- Not supported by `things3-cli` right now (no “delete/move-to-trash” write command; `things trash` is read-only listing).
-- Options: use Things UI to delete/trash, or mark as `--completed` / `--canceled` via `things update`.
-
-Notes
-- macOS-only.
-- `--dry-run` prints the URL and does not open Things.

package/skills/tmux/SKILL.md

@@ -1,121 +0,0 @@
----
-name: tmux
-description: Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
-metadata: {"clawdbot":{"emoji":"🧵","os":["darwin","linux"],"requires":{"bins":["tmux"]}}}
----
-
-# tmux Skill (Clawdbot)
-
-Use tmux only when you need an interactive TTY. Prefer exec background mode for long-running, non-interactive tasks.
-
-## Quickstart (isolated socket, exec tool)
-
-```bash
-SOCKET_DIR="${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/clawdbot-tmux-sockets}"
-mkdir -p "$SOCKET_DIR"
-SOCKET="$SOCKET_DIR/clawdbot.sock"
-SESSION=clawdbot-python
-
-tmux -S "$SOCKET" new -d -s "$SESSION" -n shell
-tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- 'PYTHON_BASIC_REPL=1 python3 -q' Enter
-tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200
-```
-
-After starting a session, always print monitor commands:
-
-```
-To monitor:
-  tmux -S "$SOCKET" attach -t "$SESSION"
-  tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200
-```
-
-## Socket convention
-
-- Use `CLAWDBOT_TMUX_SOCKET_DIR` (default `${TMPDIR:-/tmp}/clawdbot-tmux-sockets`).
-- Default socket path: `"$CLAWDBOT_TMUX_SOCKET_DIR/clawdbot.sock"`.
-
-## Targeting panes and naming
-
-- Target format: `session:window.pane` (defaults to `:0.0`).
-- Keep names short; avoid spaces.
-- Inspect: `tmux -S "$SOCKET" list-sessions`, `tmux -S "$SOCKET" list-panes -a`.
-
-## Finding sessions
-
-- List sessions on your socket: `{baseDir}/scripts/find-sessions.sh -S "$SOCKET"`.
-- Scan all sockets: `{baseDir}/scripts/find-sessions.sh --all` (uses `CLAWDBOT_TMUX_SOCKET_DIR`).
-
-## Sending input safely
-
-- Prefer literal sends: `tmux -S "$SOCKET" send-keys -t target -l -- "$cmd"`.
-- Control keys: `tmux -S "$SOCKET" send-keys -t target C-c`.
-
-## Watching output
-
-- Capture recent history: `tmux -S "$SOCKET" capture-pane -p -J -t target -S -200`.
-- Wait for prompts: `{baseDir}/scripts/wait-for-text.sh -t session:0.0 -p 'pattern'`.
-- Attaching is OK; detach with `Ctrl+b d`.
-
-## Spawning processes
-
-- For python REPLs, set `PYTHON_BASIC_REPL=1` (non-basic REPL breaks send-keys flows).
-
-## Windows / WSL
-
-- tmux is supported on macOS/Linux. On Windows, use WSL and install tmux inside WSL.
-- This skill is gated to `darwin`/`linux` and requires `tmux` on PATH.
-
-## Orchestrating Coding Agents (Codex, Claude Code)
-
-tmux excels at running multiple coding agents in parallel:
-
-```bash
-SOCKET="${TMPDIR:-/tmp}/codex-army.sock"
-
-# Create multiple sessions
-for i in 1 2 3 4 5; do
-  tmux -S "$SOCKET" new-session -d -s "agent-$i"
-done
-
-# Launch agents in different workdirs
-tmux -S "$SOCKET" send-keys -t agent-1 "cd /tmp/project1 && codex --yolo 'Fix bug X'" Enter
-tmux -S "$SOCKET" send-keys -t agent-2 "cd /tmp/project2 && codex --yolo 'Fix bug Y'" Enter
-
-# Poll for completion (check if prompt returned)
-for sess in agent-1 agent-2; do
-  if tmux -S "$SOCKET" capture-pane -p -t "$sess" -S -3 | grep -q "❯"; then
-    echo "$sess: DONE"
-  else
-    echo "$sess: Running..."
-  fi
-done
-
-# Get full output from completed session
-tmux -S "$SOCKET" capture-pane -p -t agent-1 -S -500
-```
-
-**Tips:**
-- Use separate git worktrees for parallel fixes (no branch conflicts)
-- `pnpm install` first before running codex in fresh clones
-- Check for shell prompt (`❯` or `$`) to detect completion
-- Codex needs `--yolo` or `--full-auto` for non-interactive fixes
-
-## Cleanup
-
-- Kill a session: `tmux -S "$SOCKET" kill-session -t "$SESSION"`.
-- Kill all sessions on a socket: `tmux -S "$SOCKET" list-sessions -F '#{session_name}' | xargs -r -n1 tmux -S "$SOCKET" kill-session -t`.
-- Remove everything on the private socket: `tmux -S "$SOCKET" kill-server`.
-
-## Helper: wait-for-text.sh
-
-`{baseDir}/scripts/wait-for-text.sh` polls a pane for a regex (or fixed string) with a timeout.
-
-```bash
-{baseDir}/scripts/wait-for-text.sh -t session:0.0 -p 'pattern' [-F] [-T 20] [-i 0.5] [-l 2000]
-```
-
-- `-t`/`--target` pane target (required)
-- `-p`/`--pattern` regex to match (required); add `-F` for fixed string
-- `-T` timeout seconds (integer, default 15)
-- `-i` poll interval seconds (default 0.5)
-- `-l` history lines to search (integer, default 1000)

package/skills/tmux/scripts/find-sessions.sh

@@ -1,112 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-usage() {
-  cat <<'USAGE'
-Usage: find-sessions.sh [-L socket-name|-S socket-path|-A] [-q pattern]
-
-List tmux sessions on a socket (default tmux socket if none provided).
-
-Options:
-  -L, --socket       tmux socket name (passed to tmux -L)
-  -S, --socket-path  tmux socket path (passed to tmux -S)
-  -A, --all          scan all sockets under CLAWDBOT_TMUX_SOCKET_DIR
-  -q, --query        case-insensitive substring to filter session names
-  -h, --help         show this help
-USAGE
-}
-
-socket_name=""
-socket_path=""
-query=""
-scan_all=false
-socket_dir="${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/clawdbot-tmux-sockets}"
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    -L|--socket)      socket_name="${2-}"; shift 2 ;;
-    -S|--socket-path) socket_path="${2-}"; shift 2 ;;
-    -A|--all)         scan_all=true; shift ;;
-    -q|--query)       query="${2-}"; shift 2 ;;
-    -h|--help)        usage; exit 0 ;;
-    *) echo "Unknown option: $1" >&2; usage; exit 1 ;;
-  esac
-done
-
-if [[ "$scan_all" == true && ( -n "$socket_name" || -n "$socket_path" ) ]]; then
-  echo "Cannot combine --all with -L or -S" >&2
-  exit 1
-fi
-
-if [[ -n "$socket_name" && -n "$socket_path" ]]; then
-  echo "Use either -L or -S, not both" >&2
-  exit 1
-fi
-
-if ! command -v tmux >/dev/null 2>&1; then
-  echo "tmux not found in PATH" >&2
-  exit 1
-fi
-
-list_sessions() {
-  local label="$1"; shift
-  local tmux_cmd=(tmux "$@")
-
-  if ! sessions="$("${tmux_cmd[@]}" list-sessions -F '#{session_name}\t#{session_attached}\t#{session_created_string}' 2>/dev/null)"; then
-    echo "No tmux server found on $label" >&2
-    return 1
-  fi
-
-  if [[ -n "$query" ]]; then
-    sessions="$(printf '%s\n' "$sessions" | grep -i -- "$query" || true)"
-  fi
-
-  if [[ -z "$sessions" ]]; then
-    echo "No sessions found on $label"
-    return 0
-  fi
-
-  echo "Sessions on $label:"
-  printf '%s\n' "$sessions" | while IFS=$'\t' read -r name attached created; do
-    attached_label=$([[ "$attached" == "1" ]] && echo "attached" || echo "detached")
-    printf '  - %s (%s, started %s)\n' "$name" "$attached_label" "$created"
-  done
-}
-
-if [[ "$scan_all" == true ]]; then
-  if [[ ! -d "$socket_dir" ]]; then
-    echo "Socket directory not found: $socket_dir" >&2
-    exit 1
-  fi
-
-  shopt -s nullglob
-  sockets=("$socket_dir"/*)
-  shopt -u nullglob
-
-  if [[ "${#sockets[@]}" -eq 0 ]]; then
-    echo "No sockets found under $socket_dir" >&2
-    exit 1
-  fi
-
-  exit_code=0
-  for sock in "${sockets[@]}"; do
-    if [[ ! -S "$sock" ]]; then
-      continue
-    fi
-    list_sessions "socket path '$sock'" -S "$sock" || exit_code=$?
-  done
-  exit "$exit_code"
-fi
-
-tmux_cmd=(tmux)
-socket_label="default socket"
-
-if [[ -n "$socket_name" ]]; then
-  tmux_cmd+=(-L "$socket_name")
-  socket_label="socket name '$socket_name'"
-elif [[ -n "$socket_path" ]]; then
-  tmux_cmd+=(-S "$socket_path")
-  socket_label="socket path '$socket_path'"
-fi
-
-list_sessions "$socket_label" "${tmux_cmd[@]:1}"

package/skills/tmux/scripts/wait-for-text.sh

@@ -1,83 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-usage() {
-  cat <<'USAGE'
-Usage: wait-for-text.sh -t target -p pattern [options]
-
-Poll a tmux pane for text and exit when found.
-
-Options:
-  -t, --target    tmux target (session:window.pane), required
-  -p, --pattern   regex pattern to look for, required
-  -F, --fixed     treat pattern as a fixed string (grep -F)
-  -T, --timeout   seconds to wait (integer, default: 15)
-  -i, --interval  poll interval in seconds (default: 0.5)
-  -l, --lines     number of history lines to inspect (integer, default: 1000)
-  -h, --help      show this help
-USAGE
-}
-
-target=""
-pattern=""
-grep_flag="-E"
-timeout=15
-interval=0.5
-lines=1000
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    -t|--target)   target="${2-}"; shift 2 ;;
-    -p|--pattern)  pattern="${2-}"; shift 2 ;;
-    -F|--fixed)    grep_flag="-F"; shift ;;
-    -T|--timeout)  timeout="${2-}"; shift 2 ;;
-    -i|--interval) interval="${2-}"; shift 2 ;;
-    -l|--lines)    lines="${2-}"; shift 2 ;;
-    -h|--help)     usage; exit 0 ;;
-    *) echo "Unknown option: $1" >&2; usage; exit 1 ;;
-  esac
-done
-
-if [[ -z "$target" || -z "$pattern" ]]; then
-  echo "target and pattern are required" >&2
-  usage
-  exit 1
-fi
-
-if ! [[ "$timeout" =~ ^[0-9]+$ ]]; then
-  echo "timeout must be an integer number of seconds" >&2
-  exit 1
-fi
-
-if ! [[ "$lines" =~ ^[0-9]+$ ]]; then
-  echo "lines must be an integer" >&2
-  exit 1
-fi
-
-if ! command -v tmux >/dev/null 2>&1; then
-  echo "tmux not found in PATH" >&2
-  exit 1
-fi
-
-# End time in epoch seconds (integer, good enough for polling)
-start_epoch=$(date +%s)
-deadline=$((start_epoch + timeout))
-
-while true; do
-  # -J joins wrapped lines, -S uses negative index to read last N lines
-  pane_text="$(tmux capture-pane -p -J -t "$target" -S "-${lines}" 2>/dev/null || true)"
-
-  if printf '%s\n' "$pane_text" | grep $grep_flag -- "$pattern" >/dev/null 2>&1; then
-    exit 0
-  fi
-
-  now=$(date +%s)
-  if (( now >= deadline )); then
-    echo "Timed out after ${timeout}s waiting for pattern: $pattern" >&2
-    echo "Last ${lines} lines from $target:" >&2
-    printf '%s\n' "$pane_text" >&2
-    exit 1
-  fi
-
-  sleep "$interval"
-done