3D Viewer · Semantix

Most editors show you a project as a filing cabinet: a tree on the left, tabs across the top. You navigate it by remembering where you put things.

Semantix also draws it as a space. Folders and files become lights hanging in three dimensions, connected by the relationships that actually exist in your code, and you move through it with a mouse. It is the same project the file tree is showing you — just laid out so that shape, distance and colour carry information a list can't.

This is not a diagram you generate and look at once. It's the view the project tab opens into, it updates while you work, and when an agent is running you can watch it move through your project in real time.

Where it lives#

The 3D view is what the project tab shows — the leftmost tab in the strip, wearing the project's name. It can't be closed; click it and you're back in the 3D view of the whole project. Click a file anywhere and a file tab opens beside it with code; the project tab is never taken over.

Click a folder in the explorer and, by default, that folder grows in place inside the project's sky, and the camera flies to it. You stay in one scene and open it up piece by piece. Click the project's top row and the camera rises to a top-down view of everything.

If you'd rather a folder click opened that folder as a graph of its own, in its own tab — the older behaviour — switch off Settings → Graph & Explorer → Explorer folders unfold the main graph. Either way, a folder can always be opened as its own root from its card's Move to button or the explorer's Open as Graph Root.

What a node is#

Files are orbs, coloured by their extension — .ts one colour, .css another — with the language's mark drawn white at the centre when the camera is close. Folders are rings. Every node is the same size; what tells a folder from a file is its shape, not its bulk. What varies is glow: a node with many connections — a hub — burns brighter than one with few.

Hovering any node names it and gives you the numbers — a folder shows 12 files · 340 symbols, a file its language and symbol count.

There's also one node carrying the parent folder's name in a drilled-in view. That's the way up — hover it and it says so.

What a wire is#

Wires are relationships. Two kinds, and you can tell them apart at a glance.

Code — one thing using another: imports, calls, type references. These draw as wide bolts with a direction to them.

Structure — a folder to the things inside it, or one folder to another. These draw thin, because they say where a thing lives rather than what it does.

The weight of a wire is fixed; it doesn't count relationships. When you want to know exactly what depends on what, you don't read the wires at rest, you click a node and let the sky light it for you.

The explorer and the sky stay in sync#

Open a folder in the tree and it unfolds in the sky; unfold it in the sky and the tree opens to match. The sky wakes up already shaped like your file tree. Right-click the empty sky for Expand All Folders and Collapse All Folders, which do the same to both.

That mirror applies to the root view. A folder you've opened as its own graph keeps its own shape and doesn't track the explorer.

Turning it off#

Settings → Graph & Explorer → 3D graph view, or the Toggle 3D graph on/off icon in the menu bar's 3D group — the same switch, remembered per project. It's on by default.

Turned off, the 3D viewer is genuinely off — no rendering, no physics, no animation, no graphics context. Not hidden, not paused. A folder click in the explorer becomes a plain selection, and everything else in Semantix — explorer, editor, chat, agents — works exactly as before.

Note

The sky also pauses on its own when it can't be seen. Under a file tab it stops drawing entirely. Under a surface tab — Settings, the Project Manager — it stays on as a blurred backdrop at a low frame rate. The Memory tab, which is a sky of its own, puts the project sky to sleep while it's open.

The rest of these pages#

Moving around — mouse, the navigation dial and camera buttons, and the camera that remembers where you left it.
Clicking a node — the card, and the light that shows you what a file touches.
Finding things — what lights the sky, and what doesn't.
Watching the agent work — files appearing as ghosts, code landing on a card, and the three follow modes.
When it's quiet — what the sky does when you stop touching it.
Big projects and performance — what happens at scale, and where your arrangements are kept.