Skip to content

GraphForge in VS Code

This page is synchronized from CurateLabs/graphforge-vscode at revision 7da03dd66908.

GraphForge for VS Code (CurateLabs.graphforge) brings GraphForge projects into the editor: an openCypher query surface, a set of analyst verbs (Rank, Cluster, Paths, Analyze, Similar, Find), a progressive ontology viewer, and a result graph that can display recorded evidence and knowledge status.

Advanced · Assumes familiarity with VS Code, terminal commands, and a Python or Node environment. For the Basic lessons start with Your first graph.

This page describes the pinned extension snapshot. Compatibility of a packaged extension/runtime combination with v0.6.0 still needs first-use qualification. Follow the explicit runtime selection in setup.

  • Analysts and engineers who already have (or are building) a GraphForge project and want to query and explore it without leaving VS Code.
  • Python-first analysts working out of a pyproject.toml/uv-managed project or a notebook-heavy workspace — the extension runs the same commands against the graphforge PyPI package, not just the native Node binding.
  • Agent integrations that explicitly provide access to vscode.commands.executeCommand and handle the remaining interactive dialogs — see agent-interop.md.
Surface What it does
Setup GraphForge: Check Environment and the two Setup … Binding commands report runtime status and available setup actions — see install.md.
Cypher .cypher / .cql language support with syntax highlighting, plus Run Query (and Run Query with Parameters…).
Analyst verbs Rank, Cluster, Paths, Analyze, Similar, Find — QuickPick-driven, each with an Advanced… variant for optional parameters.
Projects An Activity Bar explorer that lists folders containing a valid GraphForge FORMAT marker.
Ontology A mode badge (exploratory/advisory/strict) plus an entity/relation tree and an Ontology Viewer webview, including a Load Ontology… action.
Knowledge List, inspect, and create knowledge-ledger assertions, with Advanced commands for attaching evidence, assessing confidence, and recording status.
Result Graph A webview rendering query/verb results as a graph, styled by class and epistemic status.

The extension can execute Cypher and analyst verbs through either engine binding — a native @curatelabs/graphforge addon, or the graphforge Python package — and picks sensibly between them by default. See install.md for the full setup and selection story.

Apache-2.0 © Curate Labs Inc.