gloss

A visual pager for the terminal: like less, for images, SVGs, PDFs, STL and 3MF meshes, Markdown, HTML, plain text, JSON, Jupyter notebooks, Word, Excel, Grist, and CSV files.

Try gloss in your browser → — starts with a sample image, including on phone-width screens.

Recorded with sigmamax, including real Kitty graphics. Demo tape.

Install

brew install --cask nimblemarkets/tap/gloss     # macOS or Linux

On Debian or Ubuntu, download the .deb from the latest release and run sudo apt install ./gloss_*_linux_amd64.deb (or _arm64). The release also has archives for macOS, Linux, and Windows: one binary, nothing else to install. With Go, go install github.com/NimbleMarkets/gloss/cmd/gloss@latest builds it from source.

Use

gloss photo.png report.pdf model.stl   # page through them
gloss animation.gif                  # plays automatically; Space pauses
gloss --menu *.png                     # choose from a menu
gloss --preview ~/Documents/*          # a menu with a preview pane
gloss ~/Pictures                       # browse a folder
gloss --page 3 report.pdf              # a page of a PDF
cat drawing.svg | gloss                # read from a pipe

Key
?	Help
q	Quit
n / p	Next / previous page, or file
/, n / N	Search text; next / previous result (Esc clears)
[ / ]	Previous / next file
m / o	File menu / browse for a file
+ / -, arrows	Zoom and pan; orbit a mesh
i	Details about the file
e	Export what you see as a PNG
u	Show a selected table URL as a QR code
Space, < / > on a GIF	Pause / resume; slower / faster playback

Pictures use Kitty graphics where the terminal has them, and colored half-blocks where it does not. Drag files onto the terminal to open them; add --fetch to open a dropped web URL. The file browser offers list, columns, and places layouts, with filtering and Tab completion.

From a script or an agent

gloss works without a terminal too: it exports PNGs sized for vision models, takes out a file's text or its details, and can ask a person for a file.

gloss --output page.png --page 3 report.pdf   # a PNG, with no terminal
gloss --text report.docx                      # Markdown on stdout
gloss --grep '(?i)total' report.pdf           # the PDF pages that match, and where
gloss --info --json model.3mf                 # what a file says about itself
gloss --serve --pick                          # ask the user for a file in a browser
gloss --pick-web --prompt "Send a photo and a note" # simple upload page

Without a terminal on stdin, --serve and --pick return session JSON immediately; gloss --resume TOKEN waits for the chosen paths, --status looks without waiting, and --cancel ends the session. gloss skill schema prints the JSON Schema of everything gloss writes as JSON. Add --accept 'image/*' to require images, including SVG. See handing files over.

--pick-web lets a person send files and an optional reply (message in status/resume JSON). Add --listen IP:port and, for a wildcard bind, --advertise-host IP-or-name to pick from another device; foreground terminal sessions show a QR code. LAN mode is opt-in, plain HTTP, and token-guarded: keep the link private and use a trusted network. See the handoff guide above.

gloss also carries a skill that teaches an agent all of this, in the order it needs it: read a file's text, see a page or model as a PNG sized for its vision budget, learn a file's details as JSON, and ask you for a file. Install it for the agents on your machine, from the binary or from the repository:

gloss skill install                           # from the binary, so it matches its flags
npx skills add NimbleMarkets/gloss            # or from the repository, for every agent it finds

Read it on the site, For LLMs, or as SKILL.md.

Documentation

The documentation has the rest: the controls, the formats gloss opens and their limits, exporting for vision models, handing files over, and every option, grouped by what it is for. gloss --help lists the options, and man gloss and tab completion for bash, zsh, and fish work after a Homebrew or .deb install; the release archives carry both too.

To work on gloss, see DEVELOP.md.

License

This gloss project is released under the MIT License, see LICENSE. The licenses of the modules gloss links are in THIRD_PARTY_NOTICES.md.

Copyright (c) 2026 Neomantra Corp.

---

Made with ❤️ and 🔥 by the team behind Nimble.Markets.