(cayenne) 01/02: CAY-2946 Claude Code "plugin" for agentic coding with Cayenne

[aa...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

asf-gitbox-commits pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/cayenne.git

commit 952f6e9b80c41c30aada78bdce816702ed64ae57
Author: Andrus Adamchik <an...@objectstyle.com>
AuthorDate: Thu May 21 15:45:09 2026 -0400

    CAY-2946 Claude Code "plugin" for agentic coding with Cayenne
---
 .claude-plugin/marketplace.json | 23 +++++++++++++++++++++++
 ai-plugin/README.md             | 18 ++++++++++++------
 2 files changed, 35 insertions(+), 6 deletions(-)

diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
new file mode 100644
index 000000000..aabf36e9d
--- /dev/null
+++ b/.claude-plugin/marketplace.json
@@ -0,0 +1,23 @@
+{
+  "name": "apache-cayenne",
+  "metadata": {
+    "description": "Apache Cayenne ORM Claude Code plugins"
+  },
+  "owner": {
+    "name": "Apache Cayenne"
+  },
+  "plugins": [
+    {
+      "name": "apache-cayenne",
+      "description": "Apache Cayenne 5.0 ORM — design DataMaps, reverse-engineer schemas, generate classes, write runtime code.",
+      "author": { "name": "Apache Cayenne" },
+      "source": {
+        "type": "git",
+        "repo": "apache/cayenne",
+        "path": "ai-plugin"
+      },
+      "category": "development",
+      "tags": ["java", "orm", "cayenne", "database"]
+    }
+  ]
+}
diff --git a/ai-plugin/README.md b/ai-plugin/README.md
index 9305ba23b..8a767e7e5 100644
--- a/ai-plugin/README.md
+++ b/ai-plugin/README.md
@@ -11,18 +11,24 @@ This plugin teaches Claude how to:
 
 The plugin assumes downstream **users of Cayenne** writing their own Java apps. It does *not* cover contributor workflows for hacking on Cayenne itself.
 
-## First-time setup
+## Install
 
-> **Cayenne 5.0+ only.** The MCP server ships with Cayenne 5.0. Skills that depend on it (`cayenne-cgen`, `cayenne-modeler`, `cayenne-reverse-engineer`) will not work against earlier Cayenne versions — there is no MCP server to register. The XML-editing skills (`cayenne-modeling`) and runtime/query skills target Cayenne 5.0 idioms too; for older Cayenne, this plugin is not the right tool.
+**Cayenne 5.0+ only.** The MCP server ships with Cayenne 5.0. Skills that depend on it (`cayenne-cgen`, `cayenne-modeler`, `cayenne-reverse-engineer`) will not work against earlier Cayenne versions. The XML-editing, runtime, and query skills also target 5.0 idioms — for older Cayenne, this plugin is not the right tool.
 
-1. **Register the Cayenne MCP server.** Class generation (`cgen_run`) and opening the Modeler GUI (`open_project`) both go through this server.
-TODO: Full instructions will be on the website shorly.
+The plugin is distributed from the Apache Cayenne GitHub repository: **https://github.com/apache/cayenne**. Inside Claude Code:
 
-```bash
+```
+# register the "marketplace"
+/plugin marketplace add apache/cayenne
+
+# install the plugin
+/plugin install apache-cayenne@apache-cayenne
+
+# Install the MCP server (requires a local CayenneModeler install)
 claude mcp add cayenne --scope user -- java -jar /path/to/cayenne-mcp-server-<VERSION>.jar
 ```
 
-2. **Verify** the server is registered with `claude mcp list` — you should see an entry named `cayenne` (the MCP server alias from the command above, separate from this plugin's `apache-cayenne` name) showing as connected.
+Full MCP setup instructions will be on the Cayenne website shortly.
 
 That's it. The skills detect the MCP server at runtime; if it isn't connected they point back at this README instead of falling back to Maven or Gradle goals.