Project and Session Management

Desktop organizes sessions by workspace. You can add local projects and manage sessions, fork a copy from the current session, or start an independent side chat in the right panel.

Workspace management

A workspace is simply a local project folder. There are several ways to add one:

• After creating a session, click the folder name above the Composer to open the workspace picker, choose from recent folders, or click Choose folder… to add another local folder;
• When adding one, choose Enter an absolute path directly; the path is resolved as a local absolute path;
• Drop a folder from Finder or File Explorer onto the sidebar to add it as a workspace directly.

A newly selected folder becomes a desktop workspace and is added to the recent folder list. An empty session must have a workspace before you can send a message; existing workspaces and sessions can be switched directly from the left sidebar.

Session management

Sessions in a workspace can be created, switched, renamed, archived, restored, deleted, forked, exported, pinned, and searched. Archive, search, restore, and export are used to manage historical sessions.

The current session's title appears in the top bar and is generated by AI after the first turn. You can regenerate it from the session item or use the More menu on its right to perform session actions.

Fork a session

Fork lets you try another direction without disturbing the current conversation: it creates a copy of the current session with its full conversation history, leaving the original untouched. The copy is named with a "Fork: " prefix and is independent of the original—both can continue separately. Fork a session from its session item, or type /fork in the Composer.

Side chat

A side chat (temporary conversation) creates a temporary copy based on the main session's context: open a New conversation tab in the right panel to discuss other questions without interrupting the main session.

• Temporary conversations are not saved as regular sessions, and their content does not affect the main session;
• Temporary conversations can only use read-only tools and cannot modify files;
• It is not the same feature as Fork a session: Fork derives an independently saved copy of the session that you can keep working in, while a side chat cannot be recovered after you close its tab.

Sharing sessions with the CLI

The desktop app and the CLI read the same session data: a session created on one side appears in the other side's session list, where you can open it and continue. If both sides are open at the same time, the session list and content are not guaranteed to refresh in real time—restart or reload the other side to see the latest state.