viewimg v0.1.0A

Immutable. This exact content is served forever at /api/v1/blob/ef8894fa25941d46.

---
name: viewimg
description: Display an image in the terminal (view-only, no VLM). Renders the image as colorful block art with chafa, or opens it in a native window with `open` on macOS. Use when you or the agent want to SHOW an image to the user without analyzing it.
version: 0.1.0
---

# viewimg — show an image (view-only)

Display an image in the terminal. **View-only — never analyzes, never fires the VLM.**
Understanding is a separate, explicit step (`read_image` / `/readimg`).

## Usage

```bash
viewimg <image-file>... [--size WxH] [--open] [--no-color] [--help]
```

| Flag | Meaning |
|------|---------|
| `--size WxH` | chafa block size (default `60x30`) |
| `--open` | open **all** images together in **one** native window (uses `open -a Preview` on macOS) |
| `--no-color` | plain ASCII fallback (no ANSI color) |
| `--help` | usage |

## Behavior

- **Default:** renders each image as ANSI block art directly in the terminal via `chafa`.
- **`--open`:** opens **all** images in **one** Preview window (tabs) via `open -a Preview` —
  no multiple windows, even across repeated calls (Preview reuses its window).

## Why view-only?

`read` and `viewimg` only **display**. Understanding is opt-in: use `read_image` (tool)
or `/readimg` (command) when you actually need the image's contents. This keeps display
instant and never spends tokens on an unrequested VLM call.

## Install

```bash
bash install.sh   # creates ~/.local/bin/viewimg (Linux/macOS)
install.bat       # Windows
```

Requires `chafa` (brew install chafa) for in-terminal rendering; `open` is built into macOS.