Skiff
Menu

Settings

Settings opens over the window, with its sections in a list on the left. Chapter 1 covered Skippers and Task types. This chapter covers the rest, in the order the list shows them: Agents, Appearance, Open with, Images, Disk use and skiffd activity.

Chapter 9 of 9 · Skiff user guide

Agents

  1. Open Settings › Agents. Each row is one agent: its switch, its name, its command and its status.
  2. Click the switch to turn an agent on or off. An agent that is on shows in every launch menu. A switch is off and grey when the command is not on your PATH.
  3. To run an agent with other options, click its COMMAND cell and type the command. An empty cell uses the default shown in grey.
  4. To add your own agent, type a name in New agent name and its command, then click Add agent.
  5. Click − at the right of a row to remove the agent. An agent that Admiral or a task type uses shows that in STATUS and stays. Restore defaults brings back a removed built-in agent.
  6. Under AGENT NAMES, the two lists are the words Skiff joins into the names of new sessions, such as First Mate Pelican. Edit a list and click away to save it.
Settings, Agents. Rows for claude, codex, gemini, grok, opencode, hermes and kimi, each with a switch, its command and a status: installed, or not on PATH for kimi. claude reads installed, Admiral plus 3. A last row adds a new agent. Under the table, AGENT NAMES lists titles such as Captain and First Mate, and names such as Anchovy and Barnacle.
Settings › Agents. The switch turns an agent on. The status says who uses it.

Open with

  1. Open Settings › Open with. Each row names what Skiff hands to another program: Diffs, Text files, Markdown, HTML and Images.
  2. Type a command in the COMMAND cell and press Enter. Write {path} where the file goes. An empty cell uses the system's default app. The Open with page lists commands for common apps on Linux and macOS.
  3. Set OPENS IN for text, Markdown and HTML. External app waits for Enter in the peek. Peek runs the command inside the peek at once, for terminal tools. Diffs always use the peek. Images always use an app.
Settings, Open with. Rows: Diffs with git diff color always and Peek; Text files with gnome-text-editor and External app; Markdown with typora and External app; HTML and Images with default app.
Settings › Open with. One command per kind of file, and where it opens.

Themes and how to manage them

  1. Open Settings › Appearance. The cards are the app theme: the side panel, the bars and every pane without a project or session theme. Click a card to apply it.
  2. Type a name or a color in Find by name or color, or click a swatch, to filter the cards. All clears the filter. The line under the field counts the themes shown.
  3. Click the import button at the right of the swatches, Import themes…, to add theme files. Skiff reads the foot TOML format and Superset's JSON.
  4. Click the folder button, Open theme folder, to see the theme files. Drop files in it, come back to Skiff, and the list reads them.
  5. On Linux, the Menu row picks the window's menu: Auto, Header bar or Menu bar. A change shows the next time Skiff opens.
Settings, Appearance. A Menu row with Auto, Header bar and Menu bar. A search field, color swatches, an import button and a folder button. A grid of theme cards: Ultraviolet, Default, Neon Tropic, Moonlight, Ember, Lagoon, Violet Pulse, Manila Brief and more, each with a terminal preview and a color family.
Settings › Appearance: the app theme. The two buttons at the right import themes and open the theme folder.

A project theme or a session theme replaces the app theme in its scope. See chapter 3.

skiffd activity

skiffd is the daemon that owns every session. This page lists what it runs, also sessions that no project shows.

  1. Open Settings › skiffd activity. The band at the top shows the daemon's version, how long it has run, its session count and its memory.
  2. Each row is one session: its state, name, program, project and worktree, folder, output so far and age. A row with no project in Skiff is marked.
  3. Click a column head to sort by it. Click again to reverse.
  4. Click Reveal to close Settings and show that session. A closed project opens again for it.
  5. To end sessions, click their rows. Shift+click selects a range, Ctrl+click (⌘ on macOS) adds or drops one row, Ctrl+A selects all. Then click Sink…. The Abandon Ship dialog names the sessions. Confirm to kill them.
Settings, skiffd activity. A band reads skiffd 1.7.10, Up 3d, 6 sessions, Memory 49.0 MB, and a Sink button. A table with the columns STATE, SESSION, PROGRAM, WORKSPACE, FOLDER, OUT, AGE and ACTIONS lists six sessions, each with a Reveal button.
Settings › skiffd activity: every session the daemon runs, with Reveal and Sink.

Storage usage

  1. Open Settings › Disk use. The table counts the Skiff agent's folder: Images, with Pinned under it; Results, with a row for each Skipper and Closed work; Logs; Other; and Total.
  2. Click Flush images to remove every image that is not pinned.
  3. Click Flush done work… to remove the result files of closed work. The dialog shows the counts first. Open and working work stays, and so do the ledger and the instruction files.
  4. Auto flush removes images older than 30 days when Skiff starts. Click the switch to turn it off or on. Pinned images stay.
Settings, Disk use. A table with TYPE, FILES, SIZE and FOLDER: Images 5 files 1.4 MB with a Flush images button, Pinned, Results, atlas Skipper, Closed work with a Flush done work button, Logs, Other and Total 126 files 6.1 MB. Under it, Auto flush, 30 days, with its switch on.
Settings › Disk use. The two flush buttons free space. Auto flush ages out images.

Gallery

  1. Open Settings › Images, or click Edit › Settings › Images…. The page shows the image library as a gallery: PINNED first, then RECENT, newest first.
  2. Type in the search field to filter by file name, session or project.
  3. Click an image to select it. Ctrl+click (⌘ on macOS) selects more. The count at the right of the search field says how many.
  4. The buttons act on the selection. Open opens the image in its app. Insert into and the session name types the path into the focused pane. Pin or Unpin keeps or releases it. Copy path copies it. Delete removes the file.
Settings, Images. A search field with the count 5 and 1 selected, then the buttons Open, Insert into Rate limit middleware, Unpin, Copy path and Delete. Under PINNED, two images with one selected. Under RECENT, three images. Each image shows its name, time, project and session.
Settings › Images: the library as a gallery. Select images, then open, insert, pin, copy or delete them.