Skip to main content
Scratch chats let you start working without adding a project. Each chat gets a private folder managed by Mux, so the agent can create and edit files even though the chat is not attached to an existing repository.

Start a scratch chat

Use any of these entry points:
  • Select New scratch chat from the command palette.
  • Select the + button in the Chats section of the sidebar.
  • Press Cmd+Shift+N on macOS or Ctrl+Shift+N on Windows and Linux.
Mux creates the chat and its folder when you send the first message. Closing an empty draft does not create a folder.

Files and Git

Scratch chat files are stored under ~/.mux/scratch/<workspace-id>. The folder persists across app restarts. Mux does not initialize a Git repository for a scratch chat. Branch controls, Git status, and code review tools are hidden. You can still use the terminal and other tools that only need a working directory. Sub-agent tasks run in the same scratch folder. They do not receive an isolated Git worktree.

Archive or delete

Archiving a scratch chat keeps its conversation history and files. Deleting the chat removes its managed folder after no remaining sub-agent workspace references it. Conversation forks and full workspace-turn tasks are not supported for scratch chats in this version.