Projects and workspace

Each Dream project has its own workspace. Project tabs let you move between repositories while keeping each project's open chats and tools together.

Projects can also live on SSH hosts. Check the host label before running commands; remote project tools work on that machine.

Add and switch projects#

1. Click the + beside the project tabs, or use Open Folder on the getting-started screen.
2. Choose the folder you want to work in.
3. Select its tab to make it the active project.

The active project determines which chats, files, terminals, browser tabs, and stash items you see. Check the selected tab before sending a task or running a command. Drag project tabs to reorder them when you want related projects next to each other.

Rename or open a project externally#

Open the project's … menu and choose Edit to change its display name or icon. Click the icon to upload an image up to 5 MB, then Save. Reset a custom icon to return to automatic detection from the project. Renaming a project in Dream does not rename its folder on disk.

Use the menu's Open in choices to open the project in an available external editor.

Go back to a previous chat#

Use Back and Forward beside the project tabs to revisit projects and chats you opened. On Windows and Linux, use Alt+Left and Alt+Right; on macOS, use Command+[ and Command+]. Mouse back and forward buttons work too.

This history follows project and chat selections. Switching tool panels does not add entries, and the embedded browser has its own navigation history. Keyboard shortcuts inside the terminal or code editor are left to those tools.

Close and reopen a project#

1. Open the project's … menu and choose Close.
2. When you want to return, open the getting-started screen through the project + button.
3. Find the project in Recently closed, using its search field if needed.
4. Select the project to reopen it.

Closing a project removes its open tab; it does not delete its folder. Dream restores saved project context such as chats and open tools when possible. Do not use a closed project as a way to keep a terminal process running.

Find the workspace controls#

The left toolbar contains Chat history, New chat, and Enable multi-chat. Hover over an icon to see its label. The chat composer holds the selected model, effort and speed when supported, and permissions.

The right toolbar opens project tools:

Tool	What you can do
Git	Review changes, commit, browse history, and manage the branch's pull request
Files	Browse files, search paths, and edit file contents
Browser	Preview URLs and inspect web pages
Terminal	Run project commands in separate sessions
Stash	Save prompts and run them later

Git controls appear for repository projects. Beneath the chat, use the branch control to switch branches or create a worktree. The adjacent Git actions menu offers committing, publishing, pull requests, and worktree actions according to the branch's state.

Arrange chats and panels#

Click a tool to open its panel. Use the panel's close or collapse control when you need more room for chats, and drag panel dividers to resize the layout. Closing a tool panel is different from closing its individual terminal sessions or browser tabs.

Enable multi-chat to arrange conversations in resizable columns. Each chat has its own conversation history, while all chats in the project use the same files. Use worktrees for independent checkouts.

Capture the Dream window#

Press Ctrl+Shift+S on Windows/Linux or Command+Shift+S on macOS to capture the Dream window. Dream copies the screenshot to the clipboard, then opens a dialog to save it as a PNG. Canceling the save dialog keeps the clipboard copy. A notification reports whether the image was copied, saved, or could not be captured.

For a screenshot of a web page, use the browser's screenshot action instead.

For app-wide appearance, language, and model preferences, open Settings. To find older conversations, use Chat history or Archived chats.