Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
16 changes: 13 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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)
Expand Down Expand Up @@ -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
34 changes: 34 additions & 0 deletions docs/publishing.md
Original file line number Diff line number Diff line change
@@ -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.
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
Loading