Workspaces
A workspace is any folder containing an openspec/ directory. Register it once and SpecForge tracks every change inside it — including the ones living in other git worktrees.
Adding a workspace
Open Settings from the gear in the sidebar footer, choose + Add workspace, and pick a folder. The folder must contain an openspec/ directory; anything else is rejected as “not a valid OpenSpec workspace.”
Workspaces can also be added, removed, renamed and recoloured from the terminal UI’s Settings screen — see Terminal UI. Both surfaces share one registry.
Git-worktree discovery
If a registered workspace is a git repository, SpecForge finds its sibling worktrees automatically. You register the repository, not each worktree.
In the tree, a repository groups its worktrees together. A change open in several branches expands to one instance per worktree, and each instance carries:
- the branch name it lives on
- a task-progress meter
- a relative “modified” time
- a
[diverged]or[stale]label when that branch’s copy of the change has drifted from the default branch
Names and colours
Each workspace carries a display name you can rename inline, and a tint colour picked from a curated swatch set. Both persist across restarts, along with your expand and collapse state and the window geometry.
The colours are chosen to stay legible at small sizes — they tint rows and attribute commits per workspace rather than acting as decoration.
Local and remote state
The registry lives in SpecForge’s own configuration directory, shared by the desktop app and the terminal UI on the same machine — register a workspace in one and the other sees it.
Over SSH that directory belongs to the remote machine, so a remote terminal UI reflects whatever is registered there, independent of your laptop. There is no network sync: register workspaces on the host where you run it.