Workspaces

A workspace in Tucan Studio is just a folder on disk. It becomes the root of the folder tree in the left sidebar; everything the IDE does (Git, extensions, build commands) is scoped to that root.

Opening a workspace

Tucan Studio menu -> Open workspace folder... (Amiga: right-Amiga + O).
Or open the Welcome tab and click a recent folder.

Creating a new workspace

Tucan Studio menu -> New workspace folder... opens the New Workspace overlay. Pick a parent location, type a name, and Tucan Studio creates the directory and opens it as the active workspace.

Recent folders

The Welcome tab lists your recent workspace folders. The list is stored next to the studio binary, in config/workspaces.json.

What is stored per workspace

Settings themselves are NOT per workspace: they live beside the studio binary in config/settings.json and are shared by every project. See the Settings topic.

What a workspace does carry, in its own .studio/ folder:

File	What it holds
`menus.json`	the Workspace menu's commands
`repos.json`	the git repositories found under this workspace
`ai-sessions.json`	the AI chat sessions for this project

The folder is created on demand; it can be hidden from the tree in Settings -> File tree.

Working with files in the tree

Every row carries a [...] button (right-click does the same). On a folder: New file, New folder, Rename, Delete, Copy, Cut, Refresh, and Git. On a file: Rename, Delete, Copy, Cut.

Rename happens in place -- the row turns into an input holding the current name. Enter commits, ESC cancels. The name stays a name: a / or : in it is refused rather than quietly moving the entry somewhere else.

Delete always asks first, and says whether it is about to remove one file or a folder and everything inside it.

Copy and Cut remember one entry. Paste then appears on any folder's menu (and on a file's, meaning the folder holding it) and spells out what it will do -- "Paste 'x' here" or "Move 'x' here". Pasting never overwrites: an entry whose name is already taken arrives as "x copy", then "x copy 2". A Cut only removes the original once the copy has succeeded, and a folder cannot be pasted into itself.

A workspace that is an extension

A workspace with an extension.json in its root IS an extension: the studio picks up its menu items live while you edit them, which is how an extension is developed. See the Extensions topic.