Graph

Graph

The graph is the relationship layer behind everything else in Subimage, built and extended from the Cartography schema. The Graph explorer lets you work with those connections directly, and use an agent to drive free-form exploration, tracing how resources relate rather than reading them as flat tables.

The Graph explorer

Open Explorer to explore the relationship graph. This is a purpose-built visual explorer designed to let you query, expand and trace connections easily.

You can drive it either through Cypher via the query bar, through manual traversal (see hotkeys below), or through the Agent side-panel. We've implemented a special harness that lets the agent view and control the explorer alongside you in response to natural language questions.

Shortcuts below are written with Cmd. On Windows and Linux, use Ctrl instead. The explorer runs queries through your authenticated Subimage session, so it needs no separate database credentials.

Selection

Shortcut Action
Click Select a node or relationship
Shift-click Add a node or relationship to the selection
Cmd-click Select every node of the same type
Double-click Select a node and its neighbors
Triple-click Select a full component
Cmd+A Select everything

Camera and layout

Shortcut Action
Space Focus the selection. With nothing selected, re-center the camera
Enter Recalculate the layout
L Change the preferred layout algorithm

Expansion and adding nodes

Shortcut Action
E Expand specific neighbors by relationship for the hovered or selected node
Shift+E Expand all neighbors
A Add an object from searching your inventory

Editing and history

Removing the last node also clears the query. Undo steps back through expansions, deletions, layout changes, inventory adds, queries, and an imported file.

Shortcut Action
Delete or Backspace Remove the selection
Cmd+Z Undo last mutation
Cmd+Shift+Z Redo

The query bar

Running a query replaces the graph. Appending adds the result to what is already there. The status bar switches that result between Graph and Table. A query that returns only scalars, such as RETURN count(*), opens as a table. When a query fails, hover over its error label to see what went wrong, such as a variable that isn't defined or UNION subqueries that return different columns.

Shortcut Action
Cmd+Enter Run a query, replacing the graph
Cmd+Shift+Enter Append the result instead of replacing
Cmd+Space Open autocomplete
Up View query history

The agent

The agent sits beside the explorer and works on the same graph you do.

Shortcut Action
Cmd+/ Show or hide the agent
tip

You rarely need to write Cypher from scratch. Try asking the agent to build your graph view, or modify an existing one.

Downloading and importing graphs

A .superspider file is a saved graph you can keep or hand to a teammate.

Shortcut Action
Cmd+S Download the graph
Cmd+O Load the graph with a file

A .superspider file contains potentially sensitive resource names and properties from your environment. Be careful when sharing or storing it.

Direct Neo4j access

The in-app explorer covers most needs. If you need to query the graph from the external Neo4j Browser or a script, see Neo4j API Keys for dedicated read-only database credentials.

Programmatic access

The Subimage MCP server does not require separate Neo4j credentials. Its subimageRunCypher tool runs read-only Cypher against the graph, and the schema tools (subimageListModuleSchemaNodes, subimageGetNodesSchema) help an assistant discover what to query. See Connect via MCP.