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 <[email protected]> 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.
