Tree Lens

The Tree Lens (accessible via # /tree or the List | Graph | Tree pill in the Files tab) reads the workspace dataset as a horizontal hierarchy. It answers "what is in there" at a glance: workspace root on the left, one column per depth level, and files stacked beside their parent directory.

The Layout Discipline

Unlike standard vertical trees or naive file graphs:

1. One Column per Depth Level: The workspace root sits on the far left. Each column to the right represents an additional depth level.
2. Files Stacked Beside Parent: Files do not spawn additional columns; they stack vertically beside their parent directory folder. This ensures that horizontal distance strictly represents directory depth.
3. Dynamic Branch Sizing: Branch connecting lines scale dynamically based on the volume and depth of files in that subtree.
4. Persistent Scroll & Expansion: Expanding subdirectories or clicking files preserves the scroll offset and tree state.

---

Interactive Capabilities

• Direct In-Place Previews: Click any file node to open the safe preview drawer on the right.
• Previewer to Graph Navigation: The preview drawer includes a dedicated Graph button to instantly jump to and highlight that leaf in the Graph lens.
• Name & Extension Filtering: Filter by keyword or file extension (e.g. .ts, .json, Dockerfile) directly from the header to spotlight matching limbs while dimming unrelated paths.
• Zero Server Overhead: The layout is rendered directly in the client from <XO root>/.xo/space.json, keeping exploration responsive even across thousands of files.