Find your way around Files

Documents and project files

Files shows two kinds of things:

• Documents, listed under Your documents, are notes, plans, and instructions you keep for the project. Enjoy stores them with the project’s conversations and workflows, which by default is outside your project folder. See Choose where a project’s conversations are stored. Documents have titles, and you can pin and archive them. Agents in the project can read and update them.
• Project files are the files in your project’s folder on your computer: the code, pictures, and settings that make up what you’re building. Agents change these as they work.

Documents are written in Markdown, a plain-text format where symbols mark the formatting, such as # before a heading. Project files can be any kind of file.

Files home

Files home is the starting page of Files. Select Home at the left of the tab bar to return to it. It has:

• A search box that filters your documents by title and text, and the folders and files at the top of your project by name.
• New file, to start a document or a project file.
• Your documents, each shown as its first page, with its title printed at the top and the date it last changed underneath. Pinned documents come first, with a small pin beside the date, then the most recently created. Select More documents to see more than the first 50. A page with Markdown file under it is a plain Markdown file that an agent or another app added to your documents folder.
• Archived, at the right end of the Your documents heading, which opens documents you’ve put away. It’s hidden while you search.
• Project files, the folders and files at the top of your project folder. Select a folder to open it.

The explorer

The explorer is a panel on the left that shows everything as a tree. Select Show explorer, the folder tree button at the left end of the tab bar, to open it. In a wide window, it also opens by itself when you open your first file or document, unless you’ve already shown or hidden it.

• Files home takes you back to Files home.
• Your documents lists your documents. It’s hidden while you browse a project folder or have a project file open.
• Project files is a folder tree. Select a folder to expand it, or a file to open it.

Drag the explorer’s edge to resize it, or double-click the edge to reset its width. Select Hide explorer or press Esc to close it. In a narrow window, it opens over the page instead.

Tabs and menus

Each document or file you open gets a tab at the top, after Home. See Manage your open tabs.

Right-click a document, file, or tab to see what you can do with it, such as pin, rename, or delete. You can also point to a document or file and select the … button that appears. With the keyboard, press Shift+F10.

Getting back to where you were

• When you switch to another section and come back, Files reopens what you had open.
• Selecting a document or file mentioned in a conversation opens it in Files.
• In the web app, your browser’s Back and Forward buttons move through the folders, files, and documents you opened.
• Pinned documents and files appear under Files in the sidebar, one step in, each with a small pin at the end of its row. Select one to open it from any section. To unpin one, right-click it and choose Unpin. See Pin files and documents.

What works where

• Computer app: everything in Files. Opening files in the project’s apps, opening files in other apps, and dragging files in work only for projects on that computer.
• Web app (app.enjoy.dev): browsing, searching, creating, editing, renaming, deleting, archiving, pinning, and find and replace. Images you add to documents can be up to 2 MB each. The same limit applies in the computer app when you use another computer’s project.
• iPhone app: browsing, searching, creating, editing, renaming, deleting, and archiving. See Use Files on your iPhone.

If someone shares a computer with you as view only, you can read files but not change them. The computer’s owner can change that. See Change what a teammate can access.

If something goes wrong

A document says “Couldn’t load”

Opening it shows This document couldn’t be opened. Enjoy couldn’t read the document’s file, so it leaves the file untouched. Repair the file on disk to continue. See Fix a file that won’t save or load.

A warning says workspace files are unavailable

An amber warning icon near the bottom of the rail on the left, above Processes, means some files couldn’t be read; its badge counts them. Their contents are kept and everything else still works. Select the icon to see which ones, repair them on disk, then reopen the project. Select Dismiss to hide the warning.

The project files list shows an error

Select Try again. In the web app, or when you use another computer’s project, check that the computer the project is on is turned on and connected to the internet.