Files
capabilities/affordances/officer/core/image-rendering.md
T
officer 959a3b8e94 the capabilities Officer ships: the first affordance
Image rendering, the platform's first core affordance. It tells an agent
something it cannot discover from the filesystem: markdown images render, and
the USER'S DEVICE fetches the URL — so a local path renders nothing, silently.

Only authored content is tracked. The six item directories are created by the
platform at boot and are where the owner authors their own work, so versioning
them here would be claiming somebody else's files.
2026-08-19 07:29:25 +00:00

575 B

name, description, version
name description version
Image rendering Use when you have an image to show the user in chat. 1

![alt](https://…) renders as an image. The user's device fetches the URL, so it must be reachable from there — a local path, file://, or anything behind authentication renders nothing, and fails silently.

Reading the file yourself shows the user nothing. open/xdg-open opens a viewer on a machine nobody may be sitting at. A bare URL renders as a link, not an image.

Nowhere reachable to put it? Say so — a path looks identical to a broken image.