Choose where a project's conversations are stored
Your project’s own files stay in its folder. Enjoy keeps the project’s conversations, documents, and workflows separately, in its own storage on your computer. Because they’re outside the project folder, switching branches, using worktrees, or going back to an earlier commit never hides your latest conversations.
By default, Enjoy keeps them in its application data, in a folder named after the project with a short code added, so two projects with the same name never share one. That folder is inside:
- On a Mac:
~/Library/Application Support/app.enjoy.desktop/projects/, where~is your home folder. - On Windows:
AppData\Local\app.enjoy.desktop\projects\in your user folder. You can type%LOCALAPPDATA%\app.enjoy.desktop\projectsin File Explorer’s address bar to go there. - On Linux:
~/.local/share/app.enjoy.desktop/projects/.
You can move them to a folder you choose instead, for example one on another drive.
Steps
Select Project settings
It’s the sliders, the last of your project’s tabs under the shelf at the top of the list column.
Expand Storage
Select Storage. It shows Default or Custom, and the exact location of the project’s Enjoy files.


Choose the new folder
Select Change folder…, then choose an empty folder, or a folder that already holds this project’s Enjoy files.


Wait for the move to finish
Enjoy shows how many files it has moved so far, such as Moving 12 of 340 files…. The project switches to the new folder once every file is copied and checked.


Good to know
- Changes under Storage apply right away. You don’t need to select Save.
- To see the files, select Show in Finder on a Mac, Show in File Explorer on Windows, or Show in file manager on Linux.
- To move them back, select Use default location.
- If you choose a folder that already has this project’s Enjoy files, Enjoy asks: That folder already has Enjoy files. Use them for this project? Its current files stay where they are. Select Use these files to switch to them without copying anything.
- Projects from older versions of Enjoy kept these records in a
.enjoyfolder inside the project. Enjoy shows Your Enjoy files are moving and asks you to select Move files. If the project uses Git, Git then shows the.enjoyfolder as deleted. Commit that whenever you like. - If switching branches brings back an old
.enjoyfolder that has conversations or files the project doesn’t have, Enjoy offers to add them. Select Bring them in. Enjoy adds them without losing anything the project already has, then removes the old folder. - Removing a project from Enjoy doesn’t delete its Enjoy files. If you open the folder again, its conversations come back. Delete all application data… keeps them too. See Delete all application data.
- For a project inside WSL, Enjoy keeps these files on Windows too, not in the Linux distribution, and a folder you choose must be on this PC. If the project still has a
.enjoyfolder in the distribution, Storage shows its Linux path with a chip naming the distribution, and Enjoy can’t save to it while the distribution is stopped. See Work on a project inside WSL. - A project’s storage holds up to 100,000 conversations, questions, documents and other items. A long conversation’s extra files don’t count. Past that, Enjoy asks you to delete ones you no longer need before it saves new ones, and your existing work keeps saving.
- Each conversation has its own folder, named after its ID, inside a folder called threads. Every file in a conversation’s folder belongs to that conversation, so leave those folders as they are. To back up a conversation, copy its whole folder.
- If you keep the project’s storage in a Git repository, commit each conversation’s whole folder with
git add -A.git commit -aleaves a long conversation’s new files out, andgit cleandeletes a long conversation’s older messages if they aren’t committed. Don’t commit files named.transaction(ending in.json) or.lock: they belong to a save in progress on one computer. - Enjoy supports updating to newer versions. Going back to an earlier version isn’t supported. If you do, versions up to 0.4.12 can’t open a project whose storage holds more than 10,000 conversations, questions, documents and other items. A long conversation saved by a newer version of Enjoy shows read-only in this version, and versions up to 0.4.12 show it as couldn’t load (version 0.1.13, which reads only
.enjoyfolders, shows every conversation that way), don’t save new agent activity for it, and deleting it there leaves some of its files in its folder, which a new conversation with the same ID can then pick up. With project sync on, deleting it there also deletes the conversation on your other computers. Bringing a.enjoyfolder back into an earlier version can separate a long conversation’s files. - Every computer that opens a project’s storage through a cloud folder, a Git repository or a shared drive should run the newest version of Enjoy any of them runs. Earlier versions show long conversations a newer one saved as read-only or couldn’t load, and don’t save agent steps in them.
- If the same project is on another of your computers, Storage also has Sync across computers. See Keep a project synced across your computers.
- Storage is only in the computer app.
If something goes wrong
“macOS wouldn’t open its file picker.”
On a Mac, macOS didn’t let Enjoy show the window where you choose the folder. Quit and reopen Enjoy, then try again. If the window still doesn’t open, restart your Mac.
“Choose an empty folder, or one that already has this project’s Enjoy files.”
The folder has other files in it. Create a new, empty folder and choose that.
“That folder holds another project’s Enjoy files”
Each project needs its own folder. Choose or create a different one.
“Choose a folder outside Enjoy’s application data, or use the default location”
Folders inside Enjoy’s application data are managed by Enjoy. Choose a folder somewhere else, or select Use default location.
“Records can’t be kept inside a WSL distribution. Choose a folder on this PC.”
The folder you chose is inside a WSL Linux distribution. Choose a folder on Windows instead.
“This project’s Enjoy files aren’t available at …”
The folder you chose can’t be reached, for example because it’s on a drive that isn’t connected. Reconnect the drive. See Fix a project that’s unavailable.
Some files didn’t move
When moving old .enjoy files fails, Enjoy shows Nothing was lost. Files stay where they were until they can move. Select Try again. To stop using a project whose files won’t move, select Remove from Enjoy beside it.