Install zshdb with Homebrew, MacPorts, pacman

Project links

• Homepage
• Upstream docs
• Package manager page

Commands and aliases

• zshdb

Project history

The public GitHub repository was created on 2008-08-08. The README and Read the Docs site describe zshdb as a debugger for Zsh, aligned with Rocky Bernstein's broader Trepan debugger work and sibling shell debuggers.

zshdb's premise is deliberately narrow: Zsh scripts deserve source-level debugging too. Rather than implementing a new shell, it wraps and instruments Zsh execution to provide debugger commands familiar from gdb-style workflows.

Adoption history

Adoption is specialized. Most shell users rely on tracing, but maintainers of larger shell scripts, shell libraries, or Zsh-specific tooling can benefit from real stepping and breakpoints. That niche is why zshdb appears in several package managers even without mainstream visibility.

The package is also part of a debugger lineage: users who discover bashdb, pydb, or Trepan-style tools can recognize zshdb as the Zsh-specific member of that family.

How it is used

Developers run `zshdb` against a Zsh script to step through execution, inspect call frames and variables, set breakpoints, and diagnose control-flow problems. It is most useful when `set -x` output becomes too noisy or when a script uses Zsh-specific behavior that a POSIX-sh debugger would not understand.

Because it is a command-line debugger, packaging matters: installing it from Homebrew, MacPorts, or Arch puts a repeatable debugger binary alongside the shell it targets.

Why package nerds care

zshdb matters because it packages observability for shell scripts, a corner of developer tooling that is often under-served. Shells are everywhere, but source-level shell debuggers remain niche enough that package-manager discovery is important.

It is also a useful sibling entry for package databases: bashdb, zshdb, and Trepan-related debuggers show a family of small, language-specific debugging tools rather than one monolithic debugger package.

Timeline

• 2008-08-08: The Trepan-Debuggers/zshdb GitHub repository is created.
• 2010s: zshdb is documented through README material and Read the Docs as part of the Trepan debugger ecosystem.
• 2020s: zshdb remains packaged by Homebrew, MacPorts, and Arch-derived package metadata for users who need Zsh script debugging.

Related projects

• Related projects include Zsh, bashdb, Trepan debuggers, gdb, kshdb, shell tracing with `set -x`, and Zsh test/debugging workflows.

Sources

• https://api.github.com/repos/Trepan-Debuggers/zshdb
• https://github.com/Trepan-Debuggers/zshdb
• https://raw.githubusercontent.com/Trepan-Debuggers/zshdb/master/README.md
• https://zshdb.readthedocs.io/en/latest/