Cowork plugin + .mcpb desktop extension + release automation (#23) (#24)

github-actions[bot] · deeleeramone · dependabot[bot] · web-flow · commit b570bcb6aab3 · 2026-04-26T12:37:26.000-07:00
* build(deps): update mkdocs-literate-nav requirement in /pywry/docs (#22) Updates the requirements on [mkdocs-literate-nav](https://github.com/oprypin/mkdocs-literate-nav) to permit the latest version. - [Release notes](https://github.com/oprypin/mkdocs-literate-nav/releases) - [Commits](oprypin/mkdocs-literate-nav@v0.6.0...v0.6.3) --- updated-dependencies: - dependency-name: mkdocs-literate-nav dependency-version: 0.6.3 dependency-type: direct:production ... * build(deps): update griffe requirement in /pywry/docs (#21) Updates the requirements on [griffe](https://github.com/mkdocstrings/griffe) to permit the latest version. - [Release notes](https://github.com/mkdocstrings/griffe/releases) - [Changelog](https://github.com/mkdocstrings/griffe/blob/main/CHANGELOG.md) - [Commits](mkdocstrings/griffe@1.0.0...2.0.2) --- updated-dependencies: - dependency-name: griffe dependency-version: 2.0.2 dependency-type: direct:production ... * build(deps): update mkdocs-section-index requirement in /pywry/docs (#20) Updates the requirements on [mkdocs-section-index](https://github.com/oprypin/mkdocs-section-index) to permit the latest version. - [Release notes](https://github.com/oprypin/mkdocs-section-index/releases) - [Commits](oprypin/mkdocs-section-index@v0.3.0...v0.3.12) --- updated-dependencies: - dependency-name: mkdocs-section-index dependency-version: 0.3.12 dependency-type: direct:production ... * build(deps): update mkdocstrings requirement in /pywry/docs (#18) Updates the requirements on [mkdocstrings](https://github.com/mkdocstrings/mkdocstrings) to permit the latest version. - [Release notes](https://github.com/mkdocstrings/mkdocstrings/releases) - [Changelog](https://github.com/mkdocstrings/mkdocstrings/blob/main/CHANGELOG.md) - [Commits](mkdocstrings/mkdocstrings@0.26.0...1.0.4) --- updated-dependencies: - dependency-name: mkdocstrings dependency-version: 1.0.4 dependency-type: direct:production ... * build(deps): update mkdocs-gen-files requirement in /pywry/docs (#19) Updates the requirements on [mkdocs-gen-files](https://github.com/oprypin/mkdocs-gen-files) to permit the latest version. - [Release notes](https://github.com/oprypin/mkdocs-gen-files/releases) - [Commits](oprypin/mkdocs-gen-files@v0.5.0...v0.6.1) --- updated-dependencies: - dependency-name: mkdocs-gen-files dependency-version: 0.6.1 dependency-type: direct:production ... * Add Cowork plugin variant, .mcpb extension, and release workflow Builds two new artifacts from claude/plugins/pywry/: a Cowork .plugin (stripped of .mcp.json + hooks/ for the hosted sandbox) and a Claude Desktop .mcpb bundle whose uv runtime resolves pywry[mcp] from PyPI. A push-to-main workflow tags claude-pywry-v<version> and uploads both artifacts; plugin-manifest.yml gains a sync check for the .mcpb manifest version. --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: deeleeramone <deeleeramone@users.noreply.github.com> Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
diff --git a/.github/workflows/plugin-manifest.yml b/.github/workflows/plugin-manifest.yml
@@ -93,11 +93,34 @@ jobs:
                   except json.JSONDecodeError as e:
                       failures.append(f"{name}: {hooks} invalid JSON: {e}")
 
+          # Desktop extension (.mcpb) is keyed to the pywry plugin specifically
+          desktop_manifest = repo / "claude" / "desktop-extension" / "manifest.json"
+          pywry_entry = next((p for p in plugins if p.get("name") == "pywry"), None)
+          if pywry_entry is not None and desktop_manifest.exists():
+              try:
+                  dm = json.loads(desktop_manifest.read_text(encoding="utf-8"))
+              except json.JSONDecodeError as e:
+                  failures.append(f"{desktop_manifest}: invalid JSON: {e}")
+              else:
+                  if dm.get("version") != pywry_entry.get("version"):
+                      failures.append(
+                          f"desktop-extension/manifest.json version "
+                          f"{dm.get('version')!r} != pywry plugin "
+                          f"{pywry_entry.get('version')!r}"
+                      )
+                  if dm.get("name") != "pywry":
+                      failures.append(
+                          f"desktop-extension/manifest.json name "
+                          f"{dm.get('name')!r} != 'pywry'"
+                      )
+          elif pywry_entry is not None and not desktop_manifest.exists():
+              failures.append(f"missing {desktop_manifest}")
+
           if failures:
               for f in failures:
                   print(f"::error::{f}")
               sys.exit(1)
-          print(f"ok — {len(plugins)} plugin(s) validated")
+          print(f"ok — {len(plugins)} plugin(s) validated, .mcpb manifest in sync")
           PY
 
       - name: Check CHANGELOG was updated when plugin.json version changes
diff --git a/.github/workflows/release-claude-artifacts.yml b/.github/workflows/release-claude-artifacts.yml
@@ -0,0 +1,108 @@
+name: Release Claude artifacts
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+concurrency:
+  group: release-claude-artifacts
+  cancel-in-progress: false
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Tag and release on version bump
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Read plugin version
+        id: version
+        shell: bash
+        run: |
+          set -euo pipefail
+          VERSION=$(jq -r .version claude/plugins/pywry/.claude-plugin/plugin.json)
+          echo "value=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "tag=claude-pywry-v$VERSION" >> "$GITHUB_OUTPUT"
+          echo "Plugin version: $VERSION"
+
+      - name: Skip if tag already exists
+        id: tag_check
+        env:
+          TAG: ${{ steps.version.outputs.tag }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          if git ls-remote --tags origin "refs/tags/$TAG" | grep -q "refs/tags/$TAG"; then
+            echo "Tag $TAG already published — nothing to release."
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "Tag $TAG missing — will build and release."
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Set up Python
+        if: steps.tag_check.outputs.exists == 'false'
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.12'
+
+      - name: Build distributions (enforces version sync across all three manifests)
+        if: steps.tag_check.outputs.exists == 'false'
+        run: python claude/scripts/build_distributions.py
+
+      - name: Extract changelog section
+        id: notes
+        if: steps.tag_check.outputs.exists == 'false'
+        env:
+          VERSION: ${{ steps.version.outputs.value }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          NOTES_FILE="$RUNNER_TEMP/release-notes.md"
+          python3 - "$VERSION" > "$NOTES_FILE" <<'PY'
+          import re
+          import sys
+
+          version = sys.argv[1]
+          text = open("claude/plugins/pywry/CHANGELOG.md", encoding="utf-8").read()
+          # Match either "## 1.2.3" or "## [1.2.3]" headings
+          pattern = re.compile(
+              rf"^## \[?{re.escape(version)}\]?[^\n]*\n(.*?)(?=^## |\Z)",
+              re.MULTILINE | re.DOTALL,
+          )
+          m = pattern.search(text)
+          if m:
+              print(m.group(1).strip())
+          else:
+              print("See [CHANGELOG.md](claude/plugins/pywry/CHANGELOG.md) for details.")
+          PY
+          echo "file=$NOTES_FILE" >> "$GITHUB_OUTPUT"
+
+      - name: Configure git identity
+        if: steps.tag_check.outputs.exists == 'false'
+        shell: bash
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+      - name: Tag and create GitHub release
+        if: steps.tag_check.outputs.exists == 'false'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TAG: ${{ steps.version.outputs.tag }}
+          VERSION: ${{ steps.version.outputs.value }}
+          NOTES_FILE: ${{ steps.notes.outputs.file }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          git tag -a "$TAG" -m "pywry plugin v$VERSION" "$GITHUB_SHA"
+          git push origin "$TAG"
+          gh release create "$TAG" \
+            --title "pywry plugin v$VERSION" \
+            --notes-file "$NOTES_FILE" \
+            claude/dist/pywry-cowork.plugin \
+            claude/dist/pywry.mcpb
diff --git a/claude/CONTRIBUTING.md b/claude/CONTRIBUTING.md
@@ -48,10 +48,10 @@ summary below:
    `Release claude/plugins/pywry v0.2.0`.
 5. Tag:
    ```bash
-   git tag -a plugin-pywry-v0.2.0 -m "pywry plugin v0.2.0"
-   git push origin plugin-pywry-v0.2.0
+   git tag -a claude-pywry-v0.2.0 -m "pywry plugin v0.2.0"
+   git push origin claude-pywry-v0.2.0
    ```
-6. Users pin with `/plugin install pywry@pywry --version plugin-pywry-v0.2.0`
+6. Users pin with `/plugin install pywry@pywry --version claude-pywry-v0.2.0`
    to avoid tracking `main`.
 
 ## Adding a new plugin
diff --git a/claude/README.md b/claude/README.md
@@ -11,7 +11,7 @@ claude/
 ├── .claude-plugin/
 │   └── marketplace.json         # Single marketplace, lists every plugin below
 ├── plugins/
-│   └── pywry/                   # The canonical PyWry plugin
+│   └── pywry/                   # The canonical PyWry plugin (Claude Code)
 │       ├── .claude-plugin/plugin.json
 │       ├── .mcp.json            # Declares the `pywry` MCP server
 │       ├── agents/              # `pywry-builder` subagent
@@ -20,15 +20,50 @@ claude/
 │       ├── skills/              # pywry-orientation skill
 │       ├── CHANGELOG.md
 │       └── README.md
+├── desktop-extension/           # Claude Desktop MCP Bundle (.mcpb) source
+│   ├── manifest.json            # MCPB manifest (different schema from plugin.json)
+│   ├── pyproject.toml           # uv-runtime dependency spec → pywry[mcp]
+│   ├── src/server.py            # Re-enters pywry.mcp.__main__:main
+│   └── README.md
+├── scripts/
+│   └── build_distributions.py   # Builds dist/pywry-cowork.plugin and dist/pywry.mcpb
+├── dist/                        # Build output (gitignored)
 ├── CONTRIBUTING.md              # How to add / maintain plugins here
 └── README.md                    # (this file)
 ```
 
+`claude/plugins/pywry/` is the single source of truth. The Cowork
+`.plugin` is a build-time transform of it (with `.mcp.json` and
+`hooks/` stripped); both are produced by
+[`scripts/build_distributions.py`](scripts/build_distributions.py).
+
 Adding a sibling plugin later is a file-system operation: create
 `claude/plugins/<name>/`, add a `plugin.json`, and append an entry to
 `claude/.claude-plugin/marketplace.json`.
 
-## Installing the plugin
+## Distribution variants
+
+PyWry ships into three Claude surfaces from this directory:
+
+| Variant | Artifact | Where it lives | Install path |
+|---|---|---|---|
+| Claude Code plugin | `claude/plugins/pywry/` (directory) | GitHub marketplace, PyPI-bundled wheel, local worktree | `/plugin marketplace add deeleeramone/PyWry --path claude/.claude-plugin/marketplace.json` then `/plugin install pywry@pywry` |
+| Cowork plugin | `claude/dist/pywry-cowork.plugin` (zip) | GitHub release asset; org marketplace upload | Cowork → Customize → Plugins → Upload plugin |
+| Claude Desktop extension | `claude/dist/pywry.mcpb` (zip) | GitHub release asset | Open the `.mcpb` file in Claude Desktop |
+
+Build the two zipped artifacts with:
+
+```bash
+python claude/scripts/build_distributions.py
+```
+
+The Cowork variant intentionally drops `.mcp.json` and `hooks/`
+because Cowork's hosted sandbox cannot launch the local `pywry` CLI;
+skills, slash commands, and the `pywry-builder` subagent still work.
+The `.mcpb` ships only the MCP server (Claude Desktop has no concept
+of slash commands or subagents).
+
+## Installing the Claude Code plugin
 
 ### From GitHub (primary path)
 
diff --git a/claude/desktop-extension/README.md b/claude/desktop-extension/README.md
@@ -0,0 +1,36 @@
+# pywry — Claude Desktop extension (`.mcpb`)
+
+Native [Claude Desktop](https://claude.ai/download) integration for
+[PyWry](https://github.com/deeleeramone/PyWry). Same 66+ MCP tools as
+the Claude Code plugin, packaged as an [MCP Bundle](https://github.com/anthropics/dxt)
+so Claude Desktop installs and runs it without any manual `pip` step.
+
+## Install
+
+1. Grab `pywry.mcpb` from the latest GitHub release (or run
+   `python scripts/build_distributions.py` from the repo root to build
+   it locally).
+2. Open the file. Claude Desktop will show an install dialog —
+   confirm to add the extension.
+3. The `uv` runtime resolves `pywry[mcp]>=2.0.0` from PyPI on first
+   launch. Subsequent launches reuse the cached environment.
+
+## Verify
+
+Open a Claude Desktop conversation and ask: *"List the pywry MCP
+tools."* Claude should enumerate the `create_widget`, `show_plotly`,
+`show_dataframe`, `show_tvchart`, `tvchart_*`, and `create_chat_widget`
+families.
+
+## Differences from the Claude Code plugin
+
+This extension ships the **MCP server only**. Slash commands
+(`/pywry:doctor`, `/pywry:scaffold`, `/pywry:examples`), the
+`pywry-builder` subagent, the `pywry-orientation` skill, and the
+`ruff format` PostToolUse hook are Claude Code surfaces and are not
+expressible in the `.mcpb` format — install [the Claude Code plugin](../plugins/pywry/README.md)
+if you want those.
+
+## License
+
+Apache-2.0, same as PyWry.
diff --git a/claude/desktop-extension/manifest.json b/claude/desktop-extension/manifest.json
@@ -0,0 +1,56 @@
+{
+  "manifest_version": "0.4",
+  "name": "pywry",
+  "display_name": "PyWry",
+  "version": "0.1.0",
+  "description": "Native Claude Desktop integration for PyWry — MCP tools for generating and rendering HTML components, chat artifacts, and building native, web, or Jupyter applications with live preview. Built-in support for AgGrid, Plotly, TradingView, and more.",
+  "long_description": "PyWry is a cross-platform rendering engine and desktop UI toolkit for Python. This Desktop Extension bundles the PyWry MCP server (66+ tools) so Claude Desktop can scaffold widgets, render Plotly charts, drive AG Grid tables, build TradingView lightweight charts, and produce streaming chat artifacts — all delivered as embedded HTML resources viewable directly in the artifact pane. The `uv` runtime resolves `pywry[mcp]` from PyPI on first launch; no manual `pip install` is required.",
+  "author": {
+    "name": "PyWry",
+    "email": "pywry2@gmail.com",
+    "url": "https://github.com/deeleeramone/PyWry"
+  },
+  "homepage": "https://github.com/deeleeramone/PyWry",
+  "documentation": "https://github.com/deeleeramone/PyWry",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/deeleeramone/PyWry.git"
+  },
+  "license": "Apache-2.0",
+  "keywords": [
+    "pywry",
+    "webview",
+    "tauri",
+    "plotly",
+    "tradingview",
+    "aggrid",
+    "dashboard",
+    "charting",
+    "visualization",
+    "data-science",
+    "finance",
+    "interactive",
+    "real-time",
+    "chat",
+    "llm",
+    "agent",
+    "artifact",
+    "jupyter",
+    "notebook",
+    "python",
+    "mcp"
+  ],
+  "server": {
+    "type": "uv",
+    "entry_point": "src/server.py"
+  },
+  "tools_generated": true,
+  "prompts_generated": true,
+  "compatibility": {
+    "claude_desktop": ">=0.10.0",
+    "platforms": ["darwin", "win32", "linux"],
+    "runtimes": {
+      "python": ">=3.10"
+    }
+  }
+}
diff --git a/claude/desktop-extension/pyproject.toml b/claude/desktop-extension/pyproject.toml
@@ -0,0 +1,8 @@
+[project]
+name = "pywry-desktop-extension"
+version = "0.1.0"
+description = "PyWry MCP Bundle (.mcpb) for Claude Desktop. Wraps pywry[mcp] so the uv runtime resolves dependencies automatically."
+requires-python = ">=3.10"
+dependencies = [
+  "pywry[mcp]>=2.0.0",
+]
diff --git a/claude/desktop-extension/src/server.py b/claude/desktop-extension/src/server.py
@@ -0,0 +1,16 @@
+"""Entry point for the PyWry MCP Bundle (.mcpb) loaded by Claude Desktop.
+
+Claude Desktop's `uv` runtime resolves `pywry[mcp]` from the bundled
+`pyproject.toml`, then invokes this file. We re-enter the existing
+`pywry.mcp.__main__:main` so all 66+ tools, resources, and skill
+loaders stay in a single source tree.
+"""
+
+import sys
+
+from pywry.mcp.__main__ import main
+
+
+if __name__ == "__main__":
+    sys.argv = ["pywry-mcp", "--transport", "stdio"]
+    main()
diff --git a/claude/plugins/pywry/RELEASING.md b/claude/plugins/pywry/RELEASING.md
diff --git a/claude/scripts/build_distributions.py b/claude/scripts/build_distributions.py
diff --git a/pywry/docs/docs/mcp/plugin.md b/pywry/docs/docs/mcp/plugin.md
