Browse and search your project's folders

Steps

  1. Open Files

    Select Files in your project’s tabs, the row of icons under your projects at the top left of the window. Under Project files, you’ll see the folders and files at the top of your project folder, each as an icon with its name under it.

  2. Select a folder to open it

    The heading changes to the folder’s name, and the path above the icons shows where you are.

    Files showing the contents of a folder named src. The heading reads src, and the path above the icons reads the project name, a slash, and src. Highlighted: Folder path.Files showing the contents of a folder named src. The heading reads src, and the path above the icons reads the project name, a slash, and src. Highlighted: Folder path.
  3. Go back up

    In the path, select a folder’s name to go back to it, or the project’s name to return to the top. Select Home in the tab bar to go all the way back to Files home.

  4. Search the folder

    Type in Search project files… to show only the items in this folder whose names contain what you typed.

  5. Use the explorer for a tree view

    The explorer is the list on the left, headed Files. Under Project files, select a folder to expand or collapse it, and a file to open it.

    The explorer on the left, under the project's tabs, with the src folder expanded under Project files to show what's inside it. Highlighted: The src folder in the explorer.The explorer on the left, under the project's tabs, with the src folder expanded under Project files to show what's inside it. Highlighted: The src folder in the explorer.

Good to know

  • Folders come first, then files, in alphabetical order. Point to an item to see its path.
  • On the computer your project is on, a file’s icon shows what’s in it: a picture shows itself, a video a frame from its first moments with its length, a sound its waveform, and text and code their first lines. Other files, and every file in the web app or when you use another computer’s project, show as a page with their type, such as JSON. Icons fill in as they scroll into view.
  • The search box looks only at names in the folder you’re in. It doesn’t look in subfolders or inside files. On Files home, the same box also searches your documents.
  • To find a file anywhere in the project, type @ in a message. See Mention docs, conversations, files, and workflows with @.
  • The .git folder isn’t shown, and neither are files your computer keeps for itself, such as .DS_Store, Thumbs.db, and the ._ files a Mac adds beside your files on USB drives and network folders. Other hidden files, whose names start with a dot, are shown dimmed.
  • A folder shows up to 2,000 items. For bigger folders you’ll see Showing the first 2,000 entries. Open a smaller folder to browse more.
  • To pick up files an agent added recently, select Refresh files, the round arrow at the right end of the Project files heading. Project files also refreshes when you come back to the Enjoy window.
  • Your documents is hidden while you’re in a folder. Select Home to see your documents again.
  • When you switch to another section and back, Files returns to the folder you were in.
  • If your project has worktrees, the project’s name in the path opens Browse files in, and a chip beside Project files in the explorer does the same. Choose a worktree to browse its files, or your main folder to come back. Choose the copy you’re already in to return to its top. Your documents stay the same in every copy. See Try ideas side by side in worktrees.
  • A tab keeps the copy it was opened from. Tabs from a worktree show the worktree’s colored tile. When you switch copies, the file you have open opens from the other copy beside it, if that copy has it. Otherwise Files shows that copy’s Files home.
  • In a project inside WSL, Enjoy lists and searches the files in the Linux distribution, so names Windows can’t use, such as ones with :, are listed too. A name that isn’t valid text can’t be shown, and the list says how many it left out, such as 2 items with unsupported names aren’t shown.
  • In the web app, your browser’s Back and Forward buttons move between the folders you opened.
  • In a narrow window, such as on a phone, the explorer and the folder’s page take turns filling the window. Select the back arrow with Files beside it, at the top left, to see the explorer.
  • To browse on your phone, see Use Files on your iPhone.

If something goes wrong

“No files match in this folder.”

Nothing in this folder has your search text in its name. Check the spelling, or open the folder the file is in and search there.

A file you expect isn’t there

If an agent made it recently, select Refresh files. If it still doesn’t appear, it may be in another folder. Type @ in a message to search the whole project.

Project files shows an error

Select Try again. In a project inside WSL, if the error says the distribution stopped, select Try again on the distribution’s card at the top of the conversation list first: browsing doesn’t start it. 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.

See also

  1. 01Find your way around FilesFiles & docs · 5 min
  2. 02Open and edit project filesFiles & docs · 4 min
  3. 03Create a new file in your projectFiles & docs · 2 min
  4. 04Mention docs, conversations, files, and workflows with @Conversations · 5 min
  5. 05Try ideas side by side in worktreesBranches & changes · 5 min

Did this help?

Service

If Enjoy doesn’t work as this manual describes, a person will help.