We use cookies to understand how you use our site and improve your experience. Cookie policy
Last updated:
A session is the unit of work in Palette Desktop. It's what makes it safe to share a workspace with your team.
When you start a session, Palette Desktop creates a clone of your workspace. The agent works inside the clone. Nothing touches the main folder until you decide it should.
That clone is the sandbox. You can try things, throw things out, start over. Whatever happens in a session stays in the session until you save it back.
Two reasons.
To make agent work safe. Agents move fast. They write a lot. Without a sandbox, you'd be living with every change the agent made the moment it made it. That doesn't work for shared folders, and it doesn't really work for solo work either.
To make shared workspaces work. If your team is in the same folder, you can't have multiple people writing to it through agents at the same time. Sessions give each person their own clone to work in. Saving back is the moment of coordination.
Click "New session" in Palette Desktop. The clone gets created on your machine. You're in.
You can name the session by what you're working on (e.g., "draft Acme outreach"). Sessions persist between launches, so you can leave one open and come back to it later.
Inside a session, you run chats. One chat or several, your choice. Each chat is a conversation with an agent. The agent reads from and writes to the same sandboxed clone.
You can also run multiple sessions in parallel:
When the session is ready, you save it back to the main folder. This is the only moment when the agent's work touches your real workspace.
Before saving:
What you approve saves back. What you don't is either kept in the session or dropped.
Every save-back is logged. You can:
If you save something you didn't mean to, you can get back to where you were.
If a session went nowhere, you can discard it. The clone is deleted. Your main folder is untouched. No harm done, because nothing was ever saved back.
This is part of what makes agent work feel safe. The cost of trying something is low.