agent-media

name	agent-media
description	Preview local media in Pi TUI as true pixels when possible (images + PDF pages rasterized). Excel/HTML scrollable text. Use media_show. Never open/Preview.

agent-media (Pi)

Rules

1. User wants to see a file → call media_show with path.
2. PDF is visual: each page is rasterized to PNG (not plain text extract).
3. Images: true-pixel. Excel/HTML: scrollable text for now.
4. Tool opens interactive viewer (blocks until q/Esc).
5. Keys: n/p next/prev page · j/k text scroll · q quit.
6. Never use macOS Preview / open.

Tool

media_show
  path?: string
  from_clipboard?: boolean
  page?: number   # 0-based start page
  max_width_cells?: number
  max_height_cells?: number

Commands

• /media-show /path/to.png|pdf|xlsx|html
• /media-paste · /media-doctor