Skip to content

Cursor plugin specification and official plugins

TypeScript

schemas: allow minClientVersions on plugin manifests and marketplace entries

Cursor Agentf3efacca666f
diff --git a/schemas/marketplace.schema.json b/schemas/marketplace.schema.json
index 70eba0f5..a3ca579a 100644
--- a/schemas/marketplace.schema.json
+++ b/schemas/marketplace.schema.json
@@ -70,8 +70,31 @@
"description": {
"type": "string",
"description": "Short description of the plugin."
+ },
+ "minClientVersions": {
+ "$ref": "#/$defs/minClientVersions",
+ "description": "Minimum client versions required to install the plugin, keyed by client identifier."
}
}
+ },
+ "minClientVersions": {
+ "type": "object",
+ "minProperties": 1,
+ "properties": {
+ "cursor": {
+ "$ref": "#/$defs/semver",
+ "description": "Minimum Cursor version required to install the plugin (e.g. \"3.13.0\")."
+ }
+ },
+ "additionalProperties": {
+ "$ref": "#/$defs/semver",
+ "description": "Minimum version required for another client identifier."
+ }
+ },
+ "semver": {
+ "type": "string",
+ "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?$",
+ "description": "Strict semantic version \"X.Y.Z\" with an optional prerelease suffix."
}
}
}
diff --git a/schemas/plugin.schema.json b/schemas/plugin.schema.json
index d4c539e0..807cc0a8 100644
--- a/schemas/plugin.schema.json
+++ b/schemas/plugin.schema.json
@@ -25,6 +25,10 @@
"type": "string",
"description": "Semantic version of the plugin (e.g. \"1.2.3\")."
},
+ "minClientVersions": {
+ "$ref": "#/$defs/minClientVersions",
+ "description": "Minimum client versions required to install the plugin, keyed by client identifier."
+ },
"author": {
"$ref": "#/$defs/author",
"description": "The plugin author."
@@ -112,6 +116,25 @@
}
}
},
+ "minClientVersions": {
+ "type": "object",
+ "minProperties": 1,
+ "properties": {
+ "cursor": {
+ "$ref": "#/$defs/semver",
+ "description": "Minimum Cursor version required to install the plugin (e.g. \"3.13.0\")."
+ }
+ },
+ "additionalProperties": {
+ "$ref": "#/$defs/semver",
+ "description": "Minimum version required for another client identifier."
+ }
+ },
+ "semver": {
+ "type": "string",
+ "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?$",
+ "description": "Strict semantic version \"X.Y.Z\" with an optional prerelease suffix."
+ },
"stringOrStringArray": {
"oneOf": [
{ "type": "string" },