Skip to content

Terminals and tabs

Every worktree has its own set of tabs. Switching worktrees in the sidebar switches the tabs with it.

  • Agent session: a terminal running an agent, named after it.
  • Terminal: a plain shell in the worktree.
  • File: a text editor.
  • Browser: a web view.
  • Diff: one file’s changes, opened from the Git view.
  • iPhone Simulator and Android Emulator: a running device’s screen, when Xcode or the Android SDK is installed. ⌘S sends a screenshot of it to the worktree’s agent. The iPhone Simulator needs Apple silicon.

The + on the tab bar opens any of them: File (⌘N), Terminal (⌘T), Browser (⌘⇧B), or a session with one of your agents (⌘⌥1–9, by position). ⌃` also opens a new plain terminal.

Closing a tab that’s running an agent asks first.

ket’s terminal is built on Alacritty’s terminal engine and drawn directly on the GPU. It supports the mouse in full-screen programs, clickable links, and copying a selection with ⌘C.

Scrollback holds up to 10,000 lines or 4 MB, whichever comes first. At 120 columns that’s about 1,300 lines. ⌘F searches the whole scrollback: ↵ steps to older matches and ⇧↵ to newer ones, as do ⌘G and ⌘⇧G.

In a plain shell, ⌘K clears the screen. In an agent session it opens the command palette.

Drag a tab onto the edge of a pane to split it, or use Split pane right, Split pane down and Close pane from the command palette. Move between panes with ⌃⌥ and an arrow key.

Browser tabs run Chromium, which ket bundles. Type a bare host such as localhost:3000 and ket opens http://localhost:3000, which makes them handy for watching the app an agent is building.

Each worktree’s browser tabs keep their own sign-ins and site data, apart from your other browsers and from other worktrees, and ket deletes them along with the worktree.