logo
Install
Docs
Releases
Install
Docs
Releases
logo
What Fold is
Getting started
Sessions
Workspaces
Remote sessions
Editor
Git
Search
Notes
Terminal
Settings
Shortcuts

Updated: 2026/11/2 23:29:23

PreviousSessions
NextRemote sessions

#Workspaces

A workspace is one project: one folder, one repository. Several are open at once, and every open workspace stays live — its shells keep running and its files stay watched whether or not you are looking at it. Switching changes what you see, never what is running.

#In the sidebar

Each open workspace is a group in the sidebar, in the order they were added — drag a workspace's name up or down to change it. A group's header shows the workspace's coloured box, its name and how many sessions it has; the focused workspace's name is the bright one. Every name is spelled out — no cap, no ··· N card.

  • Click a workspace's name to focus it — or click any session row under it, which focuses its workspace too. ⌥⌘1–9 does the same by number, in sidebar order.
  • Click any workspace's box to open its tint picker — the eight tints, nothing else — without focusing it. The tint washes the whole window: the sidebar, the pane tiles, the instruments' branch, the glow.
  • Hover the header for its +: a new session in that workspace, without switching to it.
  • Right-click the header for its menu: Colour…, then Close workspace in red. Closing kills nothing — every session born there goes to the shelf, still running — and when shells are running it asks first, saying how many. A middle click on the header does the same.
  • Open workspace… ⌘O, at the foot of the sidebar, adds another.

#One rule

Sessions are window-wide; files are workspace-scoped. The Files, Git and Notes tool panes, the document panes and search always show exactly one workspace — the focused one. The sidebar shows every session, grouped under the workspace it was born in, whichever workspace you are in.

Opening a folder from the welcome page (⌘O) adds a workspace; it never replaces one.

#Branches and worktrees

The instruments at the foot of the window state git's facts for the focused workspace: the branch, the worktree, the changes and the sync state. The last fact, Claude usage, is Claude's rather than git's — see Sessions. Each fact lifts a sheet right above itself:

  • the branch fact lists branches to switch to, or names a new one;
  • the worktree fact lists the repository's worktrees and creates one — a separate folder per branch, same repo — so you can run agents on several branches at once. The file side follows one worktree; each session keeps its own working directory. A linked worktree's row wears a ✕ under the pointer: click it, confirm, and Fold runs a plain git worktree remove. Never forced — a folder with modified or untracked files is refused in git's own words and stays put. The branch outlives its folder, and the main checkout has no ✕: it is the repository, not a worktree of it.

Fold shells out to the git on your machine for all of it.