Explorer

Browse and manage the files in your project.


Files is a surface beside your session. Press ⌘B to show or hide it, or open it with ⌘T then F, Show files in the command palette, or Files in the review panel's header. Each project has one; opening it again brings it forward. Atlas watches your project, so files an agent creates, renames, or deletes appear without a refresh.

The tree stays quick in very large projects. It loads a folder the first time you open it and only draws the rows on screen.

Search files

Type in Search files at the top of the tree. The tree narrows to the files whose path contains what you typed, with their folders opened and the match in bold. Press ↓ to move into the results and Esc to clear the search. Opening a result keeps the search in the tree beside that file.

Refresh and Collapse All sit on the same row. New files and folders are on the context menu. A chain of folders that each hold a single folder shows as one row, such as vendor / atlas-engine.

Open a file

Click a file to open it in a tab. The file takes the Files tab's place, and the tree moves to the right of the file, with the file highlighted, so you can move on to the next one from there. Each file after that opens in a tab of its own beside the first; a file that already has a tab brings that tab forward.

It is the same tree throughout. Moving between the Files tab and your file tabs keeps its scroll position, your search and the folders you opened. Hide it with the tree button at the right end of the file's header and Atlas remembers the choice. A file outside the project opens without the tree.

A file with uncommitted changes shows its added and removed lines. Right-click it and choose Open Changes to jump to its diff in the review panel.

Find changed files

Atlas colors files by git status: added, modified, deleted, renamed, conflicted, or untracked. Collapsed folders take the most serious status beneath them. Files your .gitignore excludes are dimmed.

Select and move files

Click to select, ⌘-click to add, and ⇧-click to extend a selection. Drag files or folders onto another folder to move them, or drop files from your system file manager to copy them in.

Use the context menu

Right-click a row to work with it:

  • create a New File or New Folder inside a folder
  • Open a file, or Open in Default App to hand it to your system. A program is shown in Finder instead of run.
  • Open in your editor, or Open With to pick another editor Atlas found on your computer
  • Open Changes to see a changed file's diff
  • Open in Terminal to start a shell in a folder
  • Reveal in Finder to show it in your system file manager
  • Cut, Copy, Duplicate, Paste, Rename or Delete
  • Copy Path or Copy Relative Path
  • Add to .gitignore

With several rows selected, Cut, Copy, Delete and the copy-path items act on all of them. Right-click empty space to create at the project root, paste, reveal the project, open a terminal there, or Collapse All.

Show hidden files

Atlas shows dotfiles by default. Turn off Show hidden files in Settings → General when you want a cleaner tree.

Next

On this page