From df4d3c140b9fb9a1001b7526f8a48a9fbfc467fc Mon Sep 17 00:00:00 2001
From: ozzafar <48795672+ozzafar@users.noreply.github.com>
Date: Sat, 3 Oct 2026 13:58:33 +0300
Subject: [PATCH] Add simple publishing guide and bump extension to 2.4.3

Document Marketplace, Open VSX, and npm publishing. Include registry install links and retain the independent npm CLI version.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: e8c76249-e4b9-47a4-adee-0ef91ec3f978
---
 CONTRIBUTING.md    |  3 +++
 README.md          | 16 +++++++++++++---
 docs/publishing.md | 34 ++++++++++++++++++++++++++++++++++
 package-lock.json  |  4 ++--
 package.json       |  2 +-
 5 files changed, 53 insertions(+), 6 deletions(-)
 create mode 100644 docs/publishing.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index ebf23ac..3040307 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,5 +1,8 @@
 # Contributing
 
+Maintainers can follow [Publishing DebugMCP](docs/publishing.md) to release the
+extension to Visual Studio Marketplace and Open VSX, or the standalone CLI to npm.
+
 This project welcomes contributions and suggestions. Most contributions require you to
 agree to a Contributor License Agreement (CLA) declaring that you have the right to,
 and actually do, grant us the rights to use your contribution. For details, visit
diff --git a/README.md b/README.md
index a326474..b0bda06 100644
--- a/README.md
+++ b/README.md
@@ -3,10 +3,16 @@
 Let AI agents debug your code inside VS Code - set breakpoints, step through execution, inspect variables, and evaluate expressions. Works with **Codex**, **GitHub Copilot**, **GitHub Copilot CLI**, **Claude Code**, **Cline**, **Cursor**, **Windsurf**, **Roo Code**, and any MCP-compatible assistant. Compatible with any VS Code supported coding language.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 [![VS Code](https://img.shields.io/badge/VS%20Code-1.104.0+-blue.svg)](https://code.visualstudio.com/)
-[![Version](https://img.shields.io/badge/version-2.4.1-green.svg)](https://github.com/microsoft/DebugMCP)
+
+[![Version](https://img.shields.io/badge/version-2.4.3-green.svg)](https://github.com/microsoft/DebugMCP)
+
 [![VS Marketplace](https://img.shields.io/badge/VS%20Marketplace-Install-blue.svg)](https://marketplace.visualstudio.com/items?itemName=ozzafar.debugmcpextension)
 
+[![Open VSX](https://img.shields.io/badge/Open%20VSX-Install-blue.svg)](https://open-vsx.org/extension/ozzafar/debugmcpextension)
+
+[![npm](https://img.shields.io/badge/npm-debugmcp-red.svg)](https://www.npmjs.com/package/debugmcp)
 
 > 🚀 **DebugMCP CLI is now available on npm!** Debug directly from the
 > terminal **without requiring VS Code or any IDE at all** by connecting AI
@@ -38,7 +44,11 @@ Let AI agents debug your code inside VS Code - set breakpoints, step through exe
 
 ## 🚀 Quick Install
 
-**[Install from VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=ozzafar.debugmcpextension)** or use the direct link: `vscode:extension/ozzafar.debugmcpextension`
+**[Install DebugMCP from VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=ozzafar.debugmcpextension)** or use the direct link: `vscode:extension/ozzafar.debugmcpextension`
+
+**[Install DebugMCP from Open VSX Registry](https://open-vsx.org/extension/ozzafar/debugmcpextension)**
+
+**[Install debugmcp-cli from npm](https://www.npmjs.com/package/debugmcp)**
 
 ## Table of Contents
 - [Overview](#overview)
@@ -592,4 +602,4 @@ If DebugMCP has helped you debug faster, please consider giving it a star on Git
 
 ## License
 
-MIT License - See [LICENSE](LICENSE.txt) for details
+MIT License - See [LICENSE](LICENSE.txt) for details
\ No newline at end of file
diff --git a/docs/publishing.md b/docs/publishing.md
new file mode 100644
index 0000000..5a0dc2d
--- /dev/null
+++ b/docs/publishing.md
@@ -0,0 +1,34 @@
+# Publishing DebugMCP
+
+Run these commands from the **repository root**, with dependencies installed
+(`npm ci`). Before publishing, update the appropriate version: root `package.json`
+for the extension, or `npm/cli/package.json` for npm.
+
+## VS Code Marketplace
+
+```powershell
+npx vsce package
+```
+
+Upload the generated `.vsix` manually as an update at
+[the ozzafar publisher page](https://marketplace.visualstudio.com/manage/publishers/ozzafar).
+
+## Open VSX Registry
+
+With `ovsx` installed and your Open VSX access token configured (`OVSX_PAT`):
+
+```powershell
+ovsx publish
+```
+
+## npm
+
+Stay at the **repository root**, not `src\cli` or `npm\cli`:
+
+```powershell
+npm login
+npm run cli:publish
+```
+
+The root script builds and publishes `npm/cli`. Use a full repository checkout
+containing `esbuild.js`; an installed extension or a copied CLI folder is not enough.
diff --git a/package-lock.json b/package-lock.json
index 46fa81a..ba6abe6 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "debugmcpextension",
-  "version": "2.4.2",
+  "version": "2.4.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "debugmcpextension",
-      "version": "2.4.2",
+      "version": "2.4.3",
       "license": "MIT",
       "dependencies": {
         "@modelcontextprotocol/sdk": "^1.26.0",
diff --git a/package.json b/package.json
index f919b48..2d15980 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "debugmcpextension",
   "displayName": "DebugMCP — Agentic Debugging for VS Code, Cursor & More",
   "description": "Your AI agent debugs for you — right inside VS Code, Cursor & other VS Code-based editors. Let Copilot, Cline, Cursor, Codex & any MCP agent set breakpoints, step through code, and inspect variables live instead of guessing from logs.",
-  "version": "2.4.2",
+  "version": "2.4.3",
   "publisher": "ozzafar",
   "author": {
     "name": "Oz Zafar",