Files and previews

Open a file with Ctrl-b, :, then open-file and a path:

open-file report.pdf

The file opens in a new pane with a viewer that fits it. Pictures are drawn with real pixels when your terminal supports an image protocol (kitty, iTerm2, WezTerm, Ghostty, and anything with sixel). Everywhere else they are drawn with text characters, so they still show up over plain SSH.

PDFsCopy Anchor Link

Page through with ] and [. Press / to search the text on the page, n for the next match, and Esc to stop searching.

TablesCopy Anchor Link

CSV, JSONL, Parquet and spreadsheet files open as a table you can scroll and click through.

Diagrams and drawingsCopy Anchor Link

A Graphviz .dot file opens as a tree you can walk. p cycles to its source, then to the rendered drawing, then back.

An Excalidraw board opens as a list of its elements. j and k walk the list, and p draws the canvas.

3D point cloudsCopy Anchor Link

The arrow keys orbit the scan. o switches to a flat plan view from above.

Pictures from your own programsCopy Anchor Link

A program running in a pane can draw images with the kitty graphics protocol, and taiku shows them in place, inside the pane.

DesktopsCopy Anchor Link

Ctrl-b, :, then desktop lists the desktops you can drive, the same ones taiku desktop ls shows: macOS VMs (taiku vm start NAME), VNC servers (taiku desktop add NAME vnc://HOST), and the machines on your account. Pick one, or open it by name with desktop NAME. It draws live in the pane, and your clicks, scrolls and keys go to it. Ctrl-G sends the next key with Command (Super on Linux and Windows), since the terminal keeps Command for itself.

DiffsCopy Anchor Link

Ctrl-b then d opens a diff of your working tree, and Ctrl-b then g lists the changed files. Move through changes with the arrow keys. On a wide terminal the diff is side by side.