graphmind

[!NOTE] Disclosure: This project is developed using LLM-assisted engineering with nWave.

graphmind

Knowledge graphs as a long-term memory for your AI assistants

Installation

From npm

Add the plugin and built-in skills to your OpenCode configuration:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["graphmind"],
  "skills": {
    "paths": ["~/.cache/opencode/node_modules/graphmind/skill"]
  }
}

OpenCode will automatically install the plugin on startup. See the Skills section for available skills and alternative path configurations.

Features

Wikidata Query Tool

Query Wikidata for factual information about the world using the wikidata_query tool. This tool is optimized for querying the Wikidata knowledge base, which contains structured data about people, places, events, concepts, and more.

Key Features:

• Automatic Wikidata prefix injection (wd:, wdt:, p:, ps:, pq:, etc.)
• Optimized default timeout for Wikidata queries (30 seconds)
• Helpful error messages with guidance for common issues
• Support for Wikidata-specific features like the label service

Use Cases:

• Historical facts and events
• Geographical data and locations
• Information about people and organizations
• Scientific concepts and classifications
• Cultural and general world knowledge

SPARQL Query Tool

Execute SPARQL queries over RDF data sources using the sparql_query tool. This tool uses Comunica under the hood to provide flexible querying capabilities.

Supported Query Types:

• SELECT - Retrieve bindings for variables
• CONSTRUCT - Generate RDF triples
• DESCRIBE - Retrieve RDF descriptions
• ASK - Boolean queries

Supported Data Sources:

• SPARQL endpoints (e.g., DBpedia, Wikidata)
• Triple Pattern Fragments (TPF) servers
• RDF files (Turtle, N-Triples, JSON-LD, etc.)
• Solid pods
• Any URL serving RDF data

Usage Examples

Wikidata Queries

Find Information About a Person

Who is Douglas Adams and when was he born?

OpenCode will construct a Wikidata query like:

{
  "query": "SELECT ?personLabel ?birthDate WHERE { wd:Q42 wdt:P569 ?birthDate. SERVICE wikibase:label { bd:serviceParam wikibase:language 'en'. } }"
}

Find Countries by Population

What are the 10 most populous countries in the world?

Historical Events

What major events happened in 1969?

The tool automatically adds all necessary Wikidata prefixes, so you can focus on writing the query logic.

Basic SELECT Query

Query DBpedia for the first 10 triples:

Can you query DBpedia for the first 10 triples?

OpenCode will use the tool with parameters like:

{
  "query": "SELECT * WHERE { ?s ?p ?o } LIMIT 10",
  "sources": ["https://fragments.dbpedia.org/2016-04/en"]
}

Query Multiple Sources

Query across multiple RDF sources simultaneously:

Query DBpedia and Wikidata for entities related to "artificial intelligence"

CONSTRUCT Query

Generate RDF triples:

Use a CONSTRUCT query to get book information from DBpedia

Custom Output Format

Request specific output formats:

{
  "query": "SELECT * WHERE { ?s ?p ?o } LIMIT 10",
  "sources": ["https://fragments.dbpedia.org/2016-04/en"],
  "outputFormat": "text/csv"
}

Available Output Formats:

• application/json (default for SELECT)
• application/sparql-results+json
• application/sparql-results+xml
• text/csv
• text/tab-separated-values
• text/turtle (default for CONSTRUCT)
• application/trig
• application/n-triples
• application/n-quads
• application/ld+json

Advanced Options

{
  "query": "SELECT * WHERE { ?s ?p ?o } LIMIT 10",
  "sources": ["https://fragments.dbpedia.org/2016-04/en"],
  "baseIRI": "http://example.org/",
  "lenient": true,
  "httpTimeout": 30000,
  "logLevel": "debug"
}

Tool Parameters

wikidata_query

Parameter	Type	Required	Description
query	string	Yes	SPARQL query for Wikidata (prefixes added automatically)
outputFormat	string	No	Output format: json, csv, tsv, xml (default: json)
httpTimeout	number	No	HTTP timeout in milliseconds (default: 30000)
logLevel	string	No	Log level: error, warn, info, or debug

Note: The tool automatically adds common Wikidata prefixes (wd:, wdt:, p:, ps:, pq:, wikibase:, bd:, rdfs:) if they're not already in your query.

sparql_query

Parameter	Type	Required	Description
query	string	Yes	The SPARQL query string to execute
sources	string[]	Yes	One or more URLs to query over
outputFormat	string	No	Output format for results
baseIRI	string	No	Base IRI for the query
lenient	boolean	No	If true, log errors instead of throwing
httpTimeout	number	No	HTTP request timeout in milliseconds
logLevel	string	No	Log level: error, warn, info, or debug

Skills

Graphmind ships domain-specific skills that give your AI agent knowledge about SPARQL query patterns and RDF modeling conventions. Skills are instruction files that improve how agents use the plugin's tools.

Available Skills

Skill	Description
graphmind-wikidata	Answer real-world factual questions by querying Wikidata, the world's largest open knowledge base
graphmind-sparql-patterns	Common SPARQL query patterns for querying RDF knowledge graphs with Graphmind
graphmind-rdf-modeling	RDF modeling patterns and ontology conventions for knowledge graph construction

Enabling Skills

Add the skills path to your opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["graphmind"],
  "skills": {
    "paths": ["node_modules/graphmind/skills"]
  }
}

If OpenCode installed the plugin to its cache directory, use the cache path instead:

{
  "skills": {
    "paths": ["~/.cache/opencode/node_modules/graphmind/skills"]
  }
}

For local plugin installations, point to the local path:

{
  "skills": {
    "paths": [".opencode/plugins/graphmind/skills"]
  }
}

Requirements

• Node.js >= 18.0.0
• The plugin automatically installs Comunica dependencies

License

MIT