| Action | Effect |
|---|---|
| Click | Select and focus the node; File Nodes also open the file in temporary preview |
| Double-click | Select and focus the node; File Nodes also open the file as a persistent editor tab |
| Right-click | Set Context Selection if needed and open the context menu without previewing or opening a file |
Ctrl+Click (macOS) |
Open the context menu (same as right-click) |
| Drag | Reposition the node for the current graph session |
| Hover | Show tooltip with file details |
| Hover cursor | Pointer cursor |
Ctrl+Click / Cmd+Click |
Add or remove from selection |
| Action | Effect |
|---|---|
| Left-drag | Box select multiple nodes |
| Shift + left-drag | Add boxed nodes to the current selection |
| Right-drag | Pan the view |
| Scroll | Zoom in/out |
| Hover cursor | Default cursor |
| Right-click | Open background context menu |
Right-click background, nodes, multi-node selections, or edges to access context-specific actions:
| Action | Description | Undoable |
|---|---|---|
| Open File | Open in editor | - |
| Reveal in Explorer | Show in VS Code file explorer | - |
| Copy Path | Copy relative path to clipboard | - |
| Delete | Move file(s) to trash | Yes |
| Rename | Rename file via inline prompt | Yes |
| Create File | Create a new file in the same directory | Yes |
| Toggle Favorite | Mark or unmark with yellow outline | Yes |
| Add to Filter | Hide from graph via filter pattern | Yes |
| Copy Source/Target/Both Paths (edge) | Copy connected file paths from an edge | - |
Undoable actions support Ctrl+Z / Cmd+Z to undo and Ctrl+Shift+Z / Cmd+Shift+Z to redo.
See the fresh root README gallery for current graph UI screenshots.
Historical implementation notes for the first context menu pass live in archived context menu notes.
Hover any node to see:
- File path relative to workspace
- File size
- Last modified (relative timestamp like "2h ago")
- Incoming relationships
- Outgoing relationships
- Visit count
- Handling plugin
The toolbar lives in a left-side rail beside the graph. Buttons stay stacked in one column, and opening a control button reveals its panel on the right side of the graph.
Toolbar Settings Controls:
| Control | Description |
|---|---|
| Depth Mode toggle | Turns focused depth behavior on or off. |
| Depth slider | Adjusts depth limit (1-5). Only visible when Depth Mode is active. |
| DAG mode buttons | Switch layout: Default (free-form), Radial Out, Top Down, Left to Right. |
| 2D/3D toggle | Switch between 2D canvas and 3D WebGL rendering. |
| Node size buttons | Switch node sizing: Connections, File Size, Churn, or Uniform. |
| Nodes | Opens Graph Scope settings for core and plugin-added Node Types. |
| Edges | Opens Graph Scope settings for Edge Types and shows current edge colors. |
| Index Workspace / Re-index Workspace | Before indexing: runs Indexing and saves the Graph Cache. After indexing: rebuilds graph data and then refreshes layout. |
| Refresh Graph | Reruns the force graph physics/layout without rebuilding graph data. |
| Export | Dropdown for Graph Export as PNG, SVG, JPEG, JSON, or Markdown, plus Index Export symbol JSON. |
| Themes | Opens Legend Entry editing, Legend Layer priority controls, and CSS Snippet toggles. |
| Plugins | Opens the plugins panel. |
| Settings | Opens the settings panel. |
Toolbar and panel state are driven by workspace-local settings in .codegraphy/settings.json.
Panels open on the right side of the graph. Only one panel is open at a time.
Physics and general graph behavior. See Settings for details.
Choose Graph Scope for Node Types such as files, folders, packages, and plugin-added Node Types. Each row shows the current color for that Node Type. Hover a row to see a brief description and, when available, a compact example.
Choose Graph Scope for Edge Types such as NESTS, imports, calls, references, and plugin-added Edge Types. Each row shows the current color for that Edge Type. Hover a row to see what the relationship means and, when available, a source-style example.
Manage visual styling. The Legends section controls glob-based Legend styling: Legend Entries are grouped as Custom, Plugins, Material Icon Theme, and Defaults. Custom entries can be reordered. Core defaults apply first, plugin defaults apply next, and custom entries apply last. Legend Entry Toggles persist in repo settings and disable styling only; they do not hide matching graph items. The CSS Snippets section lists configured cssSnippets paths from .codegraphy/settings.json and toggles them on or off.
Toggle whole plugins on or off and drag them to change processing priority. Plugins are processed bottom-to-top, so entries nearer the top win merge conflicts. Built-in plugins show up here too. See Plugins for plugin development.
Before the workspace has an index, use Index Workspace to run Indexing. After the workspace is indexed, Re-index Workspace rebuilds graph data and then refreshes layout. Refresh Graph only reruns the force graph simulation without reprocessing source data.
The timeline bar appears below the graph after indexing. See Timeline for full details.
| Action | Effect |
|---|---|
| Click track | Jump to that point in time |
| Drag track | Scrub through time |
| Play/Pause | Toggle automatic playback |
| Current | Jump to latest commit |
| Click node | Select and focus the node; File Nodes open a temporary preview at the selected commit |
| Double-click node | Select and focus the node; File Nodes open the file at the selected commit as a persistent editor tab |
During timeline mode, destructive context menu actions (Delete, Rename, Create File, Add to Filter) are hidden.
Export from the graph toolbar export menu:
- PNG for a rasterized snapshot at the current zoom and pan
- SVG for a scalable vector preserving graph structure
- JSON for the current Visible Graph with explicit
legend,nodes, andedges - Markdown for a readable Visible Graph snapshot with legend, nodes, and edges
- Symbols JSON for indexed symbol and relationship data built from the cached analysis store