Debugger Cli

debugger-cli

**A command-line debugger built for LLM coding agents**

[](https://crates.io/crates/debugger-cli) [](LICENSE) [](https://www.rust-lang.org/)

`debugger-cli` is a cross-platform debugging tool that enables LLM coding agents (and humans!) to debug executables using the [Debug Adapter Protocol (DAP)](https://microsoft.github.io/debug-adapter-protocol/). It provides a simple, scriptable CLI interface that maintains persistent debug sessions across multiple command invocations.

Why This Exists

LLM agents need to debug programs interactively, but CLI commands are ephemeral. Traditional debuggers require an interactive session that's incompatible with agent workflows. This tool solves that by:

• Maintaining persistent sessions: A background daemon keeps the debug session alive between commands
• Buffering events: Output, breakpoint hits, and stop events are captured even when no client is connected
• Providing a unified interface: Works with any DAP adapter (lldb-dap, CodeLLDB, debugpy, Delve, etc.)
• Being LLM-friendly: Clear, parseable output optimized for agent consumption

Features

• Multi-language support: Debug C, C++, Rust, Python, Go, and more
• Zero-friction setup: debugger setup lldb installs everything you need
• Full breakpoint control: Line, function, and conditional breakpoints
• Rich inspection: Variables, expressions, stack traces, and source context
• Thread management: List, switch, and navigate threads and stack frames
• Structured output: JSON-friendly for agent consumption
• Cross-platform: Linux, macOS, and Windows support

Quick Start

Installation

# Install from crates.io
cargo install debugger-cli

# Install a debug adapter (e.g., lldb for C/C++/Rust)
debugger setup