Release v0.7.17-preview.ddviz (#22)

## Release v0.7.17-preview.ddviz (preview)

Automated release from the Datadog client plugin repository.

**When this PR is merged into `preview-ddviz`, a GitHub Release
`v0.7.17-preview.ddviz` will be created automatically.**

Co-authored-by: dd-octo-sts[bot] <200755185+dd-octo-sts[bot]@users.noreply.github.com>

Author: dd-octo-sts[bot]

.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
       "name": "datadog",
       "source": "./",
       "description": "Use Datadog directly in Claude Code through a preconfigured Datadog MCP server. Query logs, metrics, traces, dashboards, and more through natural conversation. This plugin is in preview.",
-      "version": "0.7.16-preview.ddviz",
+      "version": "0.7.17-preview.ddviz",
       "author": {
         "name": "Datadog"
       },

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "datadog",
-  "version": "0.7.16-preview.ddviz",
+  "version": "0.7.17-preview.ddviz",
   "description": "Use Datadog directly in Claude Code through a preconfigured Datadog MCP server. Query logs, metrics, traces, dashboards, and more through natural conversation. This plugin is in preview.",
   "author": {
     "name": "Datadog"
@@ -12,5 +12,6 @@
     "mcp",
     "observability",
     "productivity"
-  ]
+  ],
+  "mcpServers": "./.dd_claude-code_mcp.json"
 }

.dd_claude-code_mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "mcp": {
+      "type": "http",
+      "url": "https://${DD_MCP_DOMAIN:-not-setup}/v1/mcp?referrer_ide=claude-code-plugin&plugin_version=0.7.17-preview.ddviz&toolsets=${DD_MCP_TOOLSETS:-}",
+      "headers": {
+        "DD_API_KEY": "${DD_API_KEY:-}",
+        "DD_APPLICATION_KEY": "${DD_APPLICATION_KEY:-}"
+      }
+    }
+  }
+}

.github/workflows/release.yaml

@@ -10,6 +10,7 @@ on:
       - 'preview-*'
     paths:
       - '*-plugin/plugin.json'
+      - 'plugin.json'
       - 'package.json'
 
 permissions:
@@ -20,14 +21,16 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
 
       - name: Extract version
         id: version
         run: |
           MANIFEST=$(find . -maxdepth 2 -name plugin.json -path '*/.*-plugin/*' | head -1)
           if [ -n "$MANIFEST" ]; then
             VERSION=$(node -e "console.log(JSON.parse(require('fs').readFileSync('${MANIFEST}','utf8')).version)")
+          elif [ -f plugin.json ]; then
+            VERSION=$(node -e "console.log(JSON.parse(require('fs').readFileSync('plugin.json','utf8')).version)")
           elif [ -f package.json ]; then
             VERSION=$(node -e "console.log(JSON.parse(require('fs').readFileSync('package.json','utf8')).version)")
           else

.mcp.json

@@ -16,10 +16,6 @@ Thanks for taking the time to contribute. This document covers basic guidelines
 
 Note that this repository is a downstream artifact — it is regenerated from an internal source repository on each release. External contributions are reviewed here, then ported back to the internal source as part of the normal release flow. We will let you know in the PR if changes need to flow through that path.
 
-## Code of conduct
-
-This project follows the [Datadog Code of Conduct](https://github.com/DataDog/.github/blob/master/CODE_OF_CONDUCT.md).
-
 ## License
 
 By contributing, you agree that your contributions will be licensed under the repository's [LICENSE](LICENSE) file.

CONTRIBUTING.md

@@ -1,7 +1,4 @@
-**This feature preview of the overlay visualization**
-
-> [!IMPORTANT]
-> This is a preview of the overlay visualization feature. This is not the stable version of the Datadog Claude Code plugin. Contact us if you're interested in feature testing this new plugin.
+**This plugin is currently in Preview.**
 
 # Datadog Claude Code Plugin
 
@@ -10,7 +7,7 @@ Query your Datadog data directly from Claude Code using natural language. Ask ab
 ## What you need
 
 - A [Datadog](https://www.datadoghq.com/) account
-- [Claude Code](https://code.claude.com/docs) IDE (v2.1.20+)
+- [Claude Code](https://code.claude.com/docs) (v2.1.30+)
 
 ## Getting started
 
@@ -34,7 +31,7 @@ Start Claude Code, install the plugin from the official marketplace:
 
 > Auto-updates: Enable auto-update so Claude Code notifies when an update is available. Run /plugin, select the Marketplaces tab, select claude-plugins-official, then select Enable auto-update.
 
-Before you can start querying Datadog data, you’ll need to connect the plugin to your Datadog account. The setup process will guide you in selecting the correct Datadog MCP domain. After setup, follow the instructions shown in Claude Code.
+Before you can start querying your Datadog data, you’ll need to connect the plugin to Datadog using your account. The setup process will guide you in selecting the correct Datadog MCP domain. After setup, follow the instructions shown in Claude Code.
 
 > You can manually trigger setup by running the `/ddsetup` command.
 
@@ -43,7 +40,7 @@ Before you can start querying Datadog data, you’ll need to connect the plugin
 Once connected, just ask the agent anything about your Datadog data:
 
 ```
-Show me error logs from the last hour
+Show me error logs for the "checkout" service from the last hour
 ```
 
 ```
@@ -70,6 +67,7 @@ The plugin provides a few commands you can run in the agent to manage configurat
 
 - `/ddconfig` — change your Datadog site or switch organizations
 - `/ddtoolsets` — enable or disable groups of tools
+- `/ddviz` — enable, disable, or check the status of the visualization panel
 
 ## Advanced usage
 
@@ -99,10 +97,12 @@ When environment variables are set, `/ddsetup`, `/ddconfig`, and `/ddtoolsets` s
 
 - By default, authentication is handled via OAuth in your browser. Key authentication is also [supported](#key-authentication).
 - No Datadog credentials are sent to the AI model provider.
+- On macOS, visualization tool results can render in a native side panel. Run `/ddviz` to enable, disable, or check its status. Disabling applies to every Claude Code install sharing the default data directory (a dev build with `DDVIZ_DATA_DIR` set is controlled separately).
+- When the panel can't render, the plugin sends lightweight telemetry (a failure-reason code only, never your queries or results) so we can spot broken setups. Opt out with `DO_NOT_TRACK` or `DISABLE_TELEMETRY`.
 
 ## Support
 
-- [Datadog MCP Server Documentation](https://docs.datadoghq.com/bits_ai/mcp_server/)
+- [Datadog MCP Server Documentation](https://docs.datadoghq.com/mcp_server/)
 
 ## Legal
 

README.md

@@ -1,15 +1,15 @@
 {
+  "description": "Datadog visualizations: renders results from the get_widget and visualize_tabular_data tools as live, interactive charts in a native side panel, then closes it when the session ends. macOS only. Falls back to the sandbox URL when unavailable.",
   "hooks": {
-    "PreToolUse": [
+    "PostToolUse": [
       {
         "matcher": "^mcp__plugin_datadog_mcp__(get_widget|visualize_tabular_data)$",
-        "hooks": [{ "type": "command", "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/forward.sh", "async": true }]
+        "hooks": [{ "type": "command", "command": "bash", "args": ["${CLAUDE_PLUGIN_ROOT}/viz/hooks/forward.sh"] }]
       }
     ],
-    "PostToolUse": [
+    "SessionEnd": [
       {
-        "matcher": "^mcp__plugin_datadog_mcp__(get_widget|visualize_tabular_data)$",
-        "hooks": [{ "type": "command", "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/forward.sh", "async": true }]
+        "hooks": [{ "type": "command", "command": "bash", "args": ["${CLAUDE_PLUGIN_ROOT}/viz/hooks/session_end.sh"] }]
       }
     ]
   }

hooks/forward.sh

@@ -0,0 +1,22 @@
+---
+name: datadog-app
+description: Use ONLY when the user explicitly asks to create, scaffold, or initialize a new Datadog App project — they must use action words like "create", "scaffold", "new", or "build" together with "Datadog App" or "@datadog/apps" or "npm create @datadog/apps". Do NOT use for any question that does not involve creating a new project from scratch, including: questions about Datadog observability products (logs, metrics, APM, traces, monitors, dashboards), working inside an existing project, deploying, publishing, auth, or CI/CD.
+---
+
+# Datadog Apps
+
+Use this skill only to **scaffold a new Datadog App**. It covers nothing else.
+
+Once the app is scaffolded, all further guidance — local development, auth, deploy, publish, CI/CD, backend functions, data access, upgrading, and troubleshooting — lives in the generated project's `AGENTS.md` and `docs/agents/` files.
+
+## Reference Routing
+
+| User task                | Read                            |
+| ------------------------ | ------------------------------- |
+| Create a new Datadog App | `references/getting-started.md` |
+
+## Boundaries
+
+- This skill covers scaffolding only. Stop here once the project is created.
+- Do not provide auth, deploy, publish, CI/CD, or app logic guidance from this skill — read the project's `AGENTS.md` instead.
+- Do not cover Datadog package/platform development in this skill.