Skip to content
| Marketplace
Sign in
Visual Studio Code>Debuggers>Zsh DebugNew to Visual Studio Code? Get it now.
Zsh Debug

Zsh Debug

Preview

rogalmic

|
53,494 installs
| (0) | Free
A debugger extension for zsh scripts (using zshdb).
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

VS Code Zsh Debug

A zsh debugger GUI frontend based on awesome zshdb scripts (zshdb included in package).

Overview

This is a SIMPLE zshdb debugger frontend. Useful for learning zsh shell usage and writing simple scripts.

Useful hint: shellcheck extension does a great job with finding common script errors before debugging.

Usage

  1. Select Debug -> Add Configuration to add custom debug configuration (drop-down, path-input, etc...)
  2. Select Debug -> Start Debugging (F5) to start debugging

See https://code.visualstudio.com/docs/editor/debugging for general usage.

Sample features

  • Debugging auto-configuration via launch.json

  • Simple debugging in hello world application

  • Standard input handling via terminal

  • Pause support while script is running

  • Advanced "Watch" and "Debug console" usage

  • Conditional breakpoints usage

For Windows users:

  • Install Windows Subsystem for Linux
  • Terminal has problems with spaces in paths when powershell is used, use WSL shell instead. For beta WSL please read this
  • for now, debugging fails with zsh:15: nice(5) failed: operation not permitted (https://github.com/Microsoft/WSL/issues/1838)

For macOS users:

  • Read here if your mac has /usr/local/bin/pkill.

Dependencies

  1. zsh version 4.3.6-dev-2 or later
  2. cat, mkfifo, rm, pkill

Limitations and known problems

  • Use terminalKind@launch.json set to integrated or external for interactive scripts (using stdin)
  • Currently debugger stops at first command
  • $0 variable shows path to zshdb
  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
© 2025 Microsoft