File Explorer

Browse your workspace as a file tree — open, create, rename, copy, move and delete files and folders without leaving the editor.

What you can do

• Navigate your workspace in a file and folder tree; single-click to expand or collapse a folder
• Open a file by clicking it (or press Enter when it's selected)
• Create new files and folders
• Rename files and folders (F2, or right-click)
• Copy, cut and paste files and folders — a folder is copied with everything inside it
• Duplicate a file or folder in place
• Paste straight from the system clipboard: a screenshot becomes a real image file, copied text becomes a text file, and a file copied in Finder or File Explorer arrives under its own name
• Delete files and folders, with a confirmation prompt
• Show or hide hidden files, and sort entries by name, type or last modified
• See at a glance which files you have changed: git colours the name and marks the row, and a folder is marked when something inside it changed

Nothing is ever overwritten. A name that already exists gets the Finder treatment — report.txt arrives as report copy.txt, then report copy 2.txt.

Keyboard shortcuts

Shortcuts apply while the File Explorer is focused:

• Enter — open the selected file
• F2 — rename the selected file or folder
• Delete — delete the selected file or folder
• Cmd/Ctrl+C — copy the selected file or folder
• Cmd/Ctrl+X — cut the selected file or folder
• Cmd/Ctrl+V — paste into the selected folder
• Cmd/Ctrl+N — new file
• Cmd/Ctrl+Shift+N — new folder
• F5 — refresh the tree

Settings

• Show hidden files — include files whose names start with a dot (default: on). The editor writes .punica/ and .github/ itself, so turning this off hides its own output
• Sort order — order entries by name, type or last modified (default: name)
• Git status decorations — colour changed files and mark the folders above them (default: on)

Reading the git marks

A changed file's name takes the colour of its status and its row ends with a letter: M for modified, U for a file git is not tracking yet, A for one staged as new, D for deleted, R for renamed, ! for a conflict. A folder gets a dot instead, in the colour of the most serious change inside it. These are the same letters and colours the Source Control panel uses.

The marks keep themselves current — a file you save is marked at once, and a file changed by something else, a terminal or a build, within a few seconds. A file that is brand new to the workspace appears in the tree on the next refresh, already marked.

Getting started

Open the Explorer from the activity bar. It opens on the workspace you already have loaded.

Requirements

Pasting an image, or copying one inside the tree, needs a desktop build with binary file support. On an older build the explorer tells you so rather than writing a damaged file. Everything else works everywhere.