Project context for Electron Desktop Chat
Choose a project for a Matrix chat so future turns use that project's workspace.
A Chat conversation can belong to one project. The saved association determines the workspace directory used for future turns, whether the project is a folder, scratch workspace, or GitHub repository. Choosing a project does not change the existing transcript.
Add a project
For an existing conversation, selecting a project saves the change immediately. The selected project appears in the composer; open that control to choose another project or select Remove project context. Wait for an active run to finish, or stop it, before changing context. The change applies to future turns and does not move or rewrite project files.
When a project is unavailable
The Matrix computer validates the saved project and its workspace before starting a turn. If the workspace is unavailable, the turn fails with an error; Chat does not silently fall back to your home directory. Your saved conversation remains available.
Check the connection and project availability, then retry. You can also choose another active project or select Remove project context. If the selected harness requires a project, choose a valid project before sending again.
If saving a project change fails, Chat shows an error and reloads the saved conversation. Check the project shown in the composer before retrying. While disconnected, the picker cannot load projects; reconnect first. If the list fails to load, use Retry projects.
Context belongs to the selected Matrix computer
Switching to another Matrix computer loads that computer's conversations and projects. Choose context from the computer where you intend to run the chat.
Scope of the project picker
The picker associates one project with the conversation. It does not select branches or worktrees, show Git status, or combine several repositories into one workspace. The Matrix computer resolves the saved project to its workspace directory; the app does not supply an arbitrary local path.
Related
How is this guide?