Workspaces and windows

Switching projects

Click the project switcher at the top of the Library (the button showing the project name) to open a different folder in the current window. If you have unsaved changes, Bedrock asks before switching.

Opening a second project (new window)

To work on two projects side by side, open another window:

• File → New Window, or press ⇧⌘N, or
• click the new-window button (⧉) next to the project switcher, or
• run New window from the command palette (⌘K).

A new window starts on the welcome screen so you can open a different project. Each window is independent — its own library, editor, and prompt board. Settings that are global (theme, integrations, recent folders) are shared across windows.

How the project name is chosen

The top bar and sidebar show a project name. Bedrock derives it from the folder you opened:

• If you open a project root (e.g. my-app), that name is shown.
• If you open a docs-like subfolder (docs, doc, .ai, context, notes, .github, …), Bedrock shows the parent folder's name instead, so my-app/docs reads as my-app with a small docs tag.

The native window title updates to match, so you can tell windows apart in Mission Control and the app switcher.

The .bedrock sidecar

Bedrock keeps its own data — version history and saved composer bundles — in a hidden .bedrock/ folder inside your workspace. It never appears in the Library and is safe to commit or to ignore; a .gitignore is created inside it automatically.