Skip to content
| Marketplace
Sign in
Visual Studio Code>Debuggers>DebugPy AttacherNew to Visual Studio Code? Get it now.
DebugPy Attacher

DebugPy Attacher

DebugPy Attacher

|
306 installs
| (1) | Free
Automatically detect and attach to debugpy processes
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

DebugPy Attacher 🐍🔧

A powerful VS Code extension that automatically detects and attaches to Python debugpy processes, making remote debugging effortless and seamless.

VS Code Extension Version VS Code Extension Installs License

Demo

✨ Features

  • 🔍 Auto-detection of debugpy processes running on your system
  • ⚡ Zero/One-click attachment to discovered processes

🚀 Quick Start

1. Add DebugPy Attach to Your Code

Use one of these methods to add debugpy attachment code:

Method A: Keyboard Shortcuts

  • Cmd+K B (Mac) / Ctrl+K B (Windows/Linux) - Insert debugpy attachment code
  • Cmd+K Shift+B / Ctrl+K Shift+B - Insert debugpy attachment code with breakpoint

Method B: Code Snippets

  • Type debugpy + Tab - Insert debugpy attachment code
  • Type debugpyb + Tab - Insert debugpy attachment code with breakpoint

Method C: Command Palette

  • Cmd+Shift+P → "Debugpy: Insert Attach Code"

2. Run Your Python Application

Execute your Python script from anywhere (terminal, IDE, command line, etc.):

python your_script.py

3. Attach the Debugger

The extension will automatically detect your debugpy process. Choose from:

  • Auto-Attach: Enable in settings to automatically connect to new processes
  • Status Bar: Click the debugpy indicator in the bottom-right corner
  • Manual: Cmd+Shift+P → "Debugpy: Attach to Process"

⚙️ Configuration

Open VS Code settings and search for "debugpy" to configure:

Setting Default Description
debugpyAttacher.enableLiveMonitoring true Enable background monitoring of debugpy processes
debugpyAttacher.autoAttach true Automatically attach to new debugpy processes
debugpyAttacher.showRulerDecorations true Show visual indicators in the overview ruler
debugpyAttacher.defaultPort 5678 Default port for keyboard shortcut

🎮 Commands

Access these commands via Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux):

Command Description
Debugpy: Attach to Process Manually attach to a debugpy process
Debugpy: Insert Attach Code Insert debugpy attachment code at cursor
Debugpy: Insert Attach Code with Breakpoint Insert code with automatic breakpoint
Debugpy: Toggle Live Monitoring Enable/disable background process detection
Debugpy: Toggle Auto-Attach Enable/disable automatic attachment
Debugpy: Clean Attach Regions (Current File) Remove debugpy regions from active file
Debugpy: Clean All Attach Regions (Workspace) Remove all debugpy regions from workspace

⌨️ Keyboard Shortcuts

Shortcut Action
Cmd+K B / Ctrl+K B Insert attach code
Cmd+K Shift+B / Ctrl+K Shift+B Insert attach code with breakpoint

Note: Shortcuts only work in Python files

🐍 Requirements

  • Python with debugpy installed:

    pip install debugpy
    
  • VS Code version 1.74.0 or higher

  • Platform: macOS, Linux, or Windows

🌟 Show Your Support

If this extension helps you, please:

  • ⭐ Star the GitHub repository
  • 📝 Leave a review
  • 🐦 Share on social media

🔄 Changelog

See CHANGELOG.md for a detailed history of changes.


Happy Debugging! 🎉

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
© 2025 Microsoft