DocsCore ConceptsWorkspaces & Projects

Workspaces & Projects

Every conversation in Trace is tied to a folder on disk. You either point it at a project you already have, or let it start a new one in its default workspace.

Browse folder — work on something that already exists

Click Browse folder in the side panel and select any folder on your machine. Trace reads and edits files inside it, same as if you'd opened it in a normal code editor.

Default workspace — start something new

Click Default workspace and just describe what you want built. Trace creates a fresh project folder for you automatically inside:

text
~/Documents/Trace/greenfield

Each new thing you build from the default workspace gets its own subfolder there — named after what you asked for, with a number appended if that name is already taken (e.g. a second project called "landing page" becomes landing-page-2). Your projects never overwrite each other.

You can always find your files
Whichever way you start, the current project's path is shown at the top of the side panel. Every file Trace creates or edits lives at that path on your normal filesystem — open it in any other editor whenever you like.