pi-bash-image

pi extension that lets bash return images inline.

Normally, seeing an image takes 2 calls:

1. bash
2. read

This adds a __PI_IMAGE__ helper so bash can return the image in the same result.

It reuses pi’s public read tool for image handling, so image processing matches pi’s read behavior.

Install

pi install npm:pi-bash-image

Usage

# image in same result
agent-browser screenshot page.png && __PI_IMAGE__ page.png

# text + image together
agent-browser snapshot -i | __PI_IMAGE__ page.png

# multiple images
__PI_IMAGE__ before.png after.png

How it works

• injects a __PI_IMAGE__ shell helper into bash
• helper prints markers for image paths
• extension replaces those markers with the same content blocks pi read would return for that image
• all other bash behavior stays the same

License

MIT