Workspaces
A workspace is a folder you register with LinkCode, and every thread runs inside one.
A workspace is a folder you've registered with LinkCode. Every thread runs against a working directory, and that directory is (or belongs to) a workspace.
There are two kinds:
- Project workspaces — folders you explicitly add, usually the root of a repository you're working on.
- Chats — a single built-in workspace backed by
~/LinkCodeon disk, for threads that aren't tied to a particular project. You don't register this one yourself; LinkCode manages it.
In the sidebar
Each project workspace gets its own group in the sidebar, showing the threads that run in it. From a group's actions menu you can:
- Rename the workspace (this only changes its label in LinkCode, not the folder name on disk).
- Drag a group to reorder it relative to other workspaces, or drag a thread to reorder it within a group.
- Toggle Import history to browse that workspace's agent-native conversation history and pull entries in — see threads.
Archiving
Archive workspace unregisters the workspace from LinkCode. This is permanent — there's no restore button in the UI, and doing it again means re-adding the same folder from scratch. It only ever touches LinkCode's own record of the workspace: the folder and its contents on disk are never modified or deleted, and its threads aren't deleted either. They move to an Unregistered group instead.
The built-in Chats workspace can't be archived.
Unregistered threads
If a thread's working directory doesn't match any workspace you currently have registered — most commonly right after archiving that workspace — it shows up in the sidebar's Unregistered group rather than disappearing. Re-adding the same folder as a workspace groups those threads normally again.