The explorer

The tree in the side panel — on the right by default, or the left if you've swapped the panels. Your project's folders and files, folders first, alphabetical, with the project name in capitals at the top.

Click a file to open it. Click a folder to unfold it and grow it in the 3D view, with the camera flying to it; click just the little arrow to unfold it without going anywhere. The top row is your whole project and never folds away.

Drag the panel's inner edge to resize it, or drag it all the way shut to collapse it to a thin strip you click to bring it back. Ctrl+B slides it away and back.

Icons and badges#

Files get an icon for their language, folders get one chosen from the folder's name. A file type Semantix doesn't recognise gets a plain grey dot — it's still indexed and still opens.

A red number on the right of a row means syntax errors: the file's own count, or for a folder, everything underneath it. The name turns red with it. Hover for the exact count.

Getting around#

Opening a file from anywhere — a search result, the 3D view, the agent — selects it here and unfolds whatever it takes to show it.

↑ ↓ move, → opens a folder, ← closes it or jumps to the parent, and typing letters jumps to the first matching name. Enter opens what's focused.

Selecting more than one#

Shift+click takes a range, Ctrl+click adds and removes individual rows. Delete, cut, copy and drag all act on the whole selection.

Opening a file clears the selection, so gather your rows and act on them before clicking anything else.

Creating, renaming, deleting#

Right-click for the menu. Folders offer New File and New Folder; right-clicking the empty space below the tree creates at the project root.

• New File — type a name. Typing sub/deep/thing.ts creates the folders on the way.
• Rename — F2, or the menu. The current name comes up selected, so typing replaces it.
• Delete File / Delete Folder — the Delete key, or the menu. It asks first, listing what's about to go for a multi-selection.

Moving and copying#

Drag a row onto a folder to move it there, or onto the empty space below the tree to move it to the project root. Dragging one row of a multi-selection moves all of them. A drop asks first — Move thing.ts into src/lib? — so a click that slid a few pixels can't quietly relocate a folder. Dropping something back where it already was does nothing.

Cut, Copy and Paste are in the menu and on Ctrl+X / Ctrl+C / Ctrl+V. Paste drops into the focused folder, or into a focused file's folder, or the project root if nothing is focused.

This clipboard is Semantix's own — it doesn't carry to other applications and doesn't survive a restart. Cut rows aren't marked in any way.

The rest of the menu#

• Open File, and Collapse / Expand on a folder.
• Open as Graph Root (folders) — opens that folder as a 3D graph of its own, in a new tab.
• Copy Name, Copy Relative Path, Copy Absolute Path.
• Reveal in File Manager — opens your system file manager with the item selected.
• Open in Terminal (folders) — starts a shell in that folder and opens the panel.
• Run in Browser — only on .html, .htm and .svg. Serves the file and opens your browser.

The top row — the project itself — has its own version: New File, New Folder, Expand All Folders, Collapse All Folders, then Open in Terminal, Reveal, Paste and the copy-path trio. The same two tree-wide items are on the right-click menu of the 3D view's empty space.

The same menus appear on editor tabs.

What you won't find here#

There's no duplicate, no "open to the side", no refresh button, no sort control, no filter box, and no way to show hidden files. There's no inline rename — renaming is always the dialog — and you can't drag files in from outside the application.

What's hidden#

The tree shows what Semantix indexed, and the indexer skips a standard list so your project looks like your project rather than like its dependencies: everything starting with a dot, anything your .gitignore excludes, and the usual heavy folders — node_modules, target, dist, build, .next, venv, __pycache__, coverage, vendor and their neighbours.

There is no file-type whitelist. An unusual extension is still indexed and still shown.

While the agent works#

The tree follows along. When the agent starts writing a file, the folders leading to it unfold and the file is revealed the moment it lands — including files that didn't exist a second earlier. When it reads a file, that file is revealed too, as long as the follow control isn't switched fully off.

Only the conversation you're actually looking at can move your tree; an agent working in another chat won't yank it around.

Nothing folds by itself. A turn that touched five folders leaves them open, and they stay open until you close them — one by one, or all at once with Collapse All Folders.

Files the agent creates and deletes appear and disappear on their own, and so do changes made outside Semantix entirely.

→ Watching it work — the follow modes and what each one covers.