KEYBINDINGS - mark-ik/graphshell GitHub Wiki
GraphShell Keyboard Shortcuts
-
Home / Escape: Toggle between Graph and Detail views
-
C: Center and fit all nodes to screen (Graph view only)
-
N: Create new node at random position near graph center
- Newly created node is automatically selected (turns gold)
- Type URL in omnibar and press Enter to navigate the node
- A tab/webview will be created for the node
-
Delete / Backspace: Remove selected nodes
- Also closes associated tabs/webviews
- Works with multiple selection
-
Click: Select single node (turns gold)
-
Shift+Click: Add/remove from selection
- Selected nodes can be navigated via omnibar
-
T: Toggle physics simulation on/off
-
P: Show/hide physics configuration panel
Mouse Controls (Graph View)
-
Click & Drag node: Move node position
-
Scroll wheel: Zoom in/out
-
Middle-click drag: Pan view
-
Double-click node: Switch to Detail view focused on that node
Creating and Navigating New Nodes
- Press N to create new node (appears as gray "about:blank")
- Node is auto-selected (gold highlight)
- Type URL in omnibar (top toolbar)
- Press Enter
- Node URL updates, tab/webview created, node turns blue (active)
- Press Home to toggle to Detail view and see rendered page
Initial Tab = Initial Node
- On startup, one node is created for the starting URL
- The initial webview/tab is automatically mapped to this node
- Tabs and nodes maintain 1:1 correspondence
- Select a node (click it)
- Type new URL in omnibar and press Enter
- The selected node's webview navigates to new URL
- If node has no webview yet, one is created
- Select node(s) in Graph view
- Press Delete or Backspace
- Node removed from graph, tab closed
- Nodes start as "Cold" (gray, no webview)
- Typing URL for selected node promotes it to "Active" (blue, has webview)
- Physics simulation helps organize nodes spatially
- Graph persists across restarts (saved to disk)
⚠️ **GitHub.com Fallback** ⚠️