Repository navigation
Images
Skiff keeps the images that you drop or paste on a pane in one library on this computer. The pane gets the path of the copy, so an agent can read the image.
- Drop files from another app on a pane. Skiff types their paths into the pane as a paste, with one space after each path.
- An image is copied first, and the pane gets the path of the copy. Skiff knows an image by its first bytes, not by its extension. Other files keep their own path.
- Paste with Ctrl+Shift+V (⌘+V on macOS). Text pastes as before. When the clipboard has no text, a file list does what a drop does, and an image is saved as PNG. Bare Ctrl+V stays with the terminal.
- An image larger than 50 MB is not copied. Skiff types its own path.
The copies go to cache/ in the Skiff agent's folder. Skiff makes that folder when it starts, so the cache does not need the Skiff agent to be on. If Skiff cannot make the folder, for example when it is on a disk that is not connected, a drop, a paste and the library show one line: "Skiff cannot make the folder PATH." Skiff does not use a different folder. The same image is one file: a second drop of it writes nothing.
When Skiff starts Claude Code, it gives it read access to the image folder.
File › Images… opens the library in a dialog. Ctrl+Alt+Shift+I (⌘+Alt+Shift+I on macOS), Images… in the palette and Images… in the pane menu also open it.
The dialog shows every image in the cache as a grid of thumbnails. Pinned images come first, under Pinned. The other images follow, under Recent. Each section shows the newest image first. Each tile shows the image, its name, the session that last got it and the time. A pasted image has the name "Pasted image". With no images, the dialog reads "No images".
Type to search the images. The count shows how many images match, such as "2 of 8". With no match, the dialog reads "No images match". Down goes from the search into the grid. Up on the top row goes back to the search.
A click selects a tile. Ctrl+click (⌘+click on macOS) adds a tile to the selection or removes it. Shift+click selects a range. The count shows the number of selected images.
Insert types the path of each selected image into the pane that had focus when the dialog opened, in grid order, with a space between the paths. Then the dialog closes. The button names that pane. With no pane, Insert is off.
Pin and Delete act on the selection. The dialog stays open. Delete asks first when two or more images are selected.
Settings › Images shows the same library as a gallery. Open it with Settings › Images… in the Edit menu.
| Action | Key | Result |
|---|---|---|
| Click the tile | Select the image. | |
| Ctrl+click, Shift+click | Space, Shift+Arrows, Ctrl+A (⌘+A on macOS) | Change the selection. |
| Insert, double-click the tile | Enter, I | Type the selected paths into the pane, and close the dialog. |
| Pin / Unpin | P | Keep the selected images when Skiff flushes the cache. |
| Delete | Delete | Delete the selected image files. |
| Arrows | Go to the next image in the grid. | |
| Type | Search the images. | |
| Esc | Close the dialog. |
Settings › Disk use counts the Skiff agent's folder. See Skiff agent › Disk use.