Grafema Explore — VS Code Extension
Interactive graph navigation for Grafema code analysis.
Features
- Find Node at Cursor (Cmd+Shift+G) — Find the graph node at your cursor position
- Explore Edges — Expand nodes to see incoming/outgoing edges
- Navigate Graph — Click on edges to explore connected nodes
- Go to Source — Click on any node to jump to its location in code
- Path Highlighting — Green markers show your navigation trail
- Copy Tree State — Copy the current exploration tree for debugging
Requirements
- Grafema graph database (
.grafema/graph.rfdb) in your workspace
- Run
grafema analyze first to create the graph
Installation from Source
cd packages/vscode
./scripts/install-local.sh
Usage
- Open a project that has been analyzed with
grafema analyze
- Open the "Grafema Explore" panel in the Explorer sidebar
- Press Cmd+Shift+G (Mac) or Ctrl+Shift+G (Windows/Linux) to find the node at cursor
- Expand nodes to explore their edges
- Click on nodes to navigate to source code
Configuration
| Setting |
Description |
Default |
grafema.rfdbBinaryPath |
Custom path to rfdb-server binary |
Auto-detected |
grafema.rfdbTransport |
Transport type: "unix" or "websocket" |
"unix" |
grafema.rfdbWebSocketUrl |
WebSocket URL (when transport is "websocket") |
"ws://localhost:7474" |
WebSocket Transport (for Web / Remote Environments)
For browser-based VS Code (vscode.dev) or remote development (code-server, Gitpod), configure WebSocket transport:
Start rfdb-server with WebSocket support:
rfdb-server ./path/to/graph.rfdb --socket /tmp/rfdb.sock --ws-port 7474
Configure the extension:
{
"grafema.rfdbTransport": "websocket",
"grafema.rfdbWebSocketUrl": "ws://localhost:7474"
}
For remote access via SSH tunnel:
ssh -L 7474:127.0.0.1:7474 user@remote-server
Development
# Build
pnpm build
# Watch mode
pnpm watch
# Run in VS Code
# 1. Open packages/vscode in VS Code
# 2. Press F5 to launch Extension Development Host
| |
