Editors and Terminal

VS Code, Cursor, and Terminal can open a folder when the layout launches. In the Work context section, their row reads Add a folder until you choose one.

Choose the folder

Click the app’s row to open its dialog, then:

• click Choose… and pick the folder,
• drag the folder from the Finder onto the card, or
• type its path, such as ~/Projects/my-app.

The path must be absolute, or start with ~/. Once a folder is set, Show in Finder reveals it and Remove clears it. Click Save to keep your choice.

If the folder doesn’t exist, the dialog says so: “This folder doesn’t exist. Launch layout reports it until you choose another one.” The row in Work context then shows a warning triangle.

VS Code and Cursor

When the layout launches, Layout finds or opens a window of the editor that shows your project, and places it in the editor’s zone:

1. Layout first looks for a window that already shows this project. A window matches when the file it shows is inside the folder or, when the editor doesn’t report a file, when its title contains the exact name of the folder.
2. If exactly one window matches, Layout uses it. If two windows match equally, for example two projects with the same folder name, Layout doesn’t guess and reuses neither.
3. Otherwise, Layout asks the editor’s own command-line tool, bundled inside the app, to open the folder in a new window (--new-window). If an existing window starts showing the project after that, Layout accepts it too.

If no matching or new window appears within ten seconds, Layout shows an error instead of placing an unrelated window: “No matching or new context window appeared. Open the configured folder or URLs in the app, then retry Launch layout.”

Layout doesn’t run any project command. It only asks the editor to open the folder.

Terminal

Terminal opens a new window in the folder each time the layout launches. No command runs in it.

Because Terminal doesn’t reuse a window, launching the same layout again opens another Terminal window.

Errors you may see

Message	What to do
Folder not found, followed by the path	The folder was moved or deleted. Choose it again.
Choose an absolute folder path (or ~/…).	Type a full path, or one that starts with ~/.
The configured app is not installed.	Install the app, or remove it from the workspace.
No matching or new context window appeared…	Open the folder in the app yourself, then launch the layout again.

Errors in one app don’t stop the others from launching.