v1.0.2

What's Changed

Improved Error Diagnostics

• Enhanced EOF error messages with comprehensive troubleshooting hints when Xdebug disconnects unexpectedly:
  • Breakpoint location not reached during script execution
  • Missing xdebug.output_dir directory (common issue when xdebug.mode=trace)
  • PHP fatal errors or exceptions
  • Xdebug log location for further investigation

New Features

• Port conflict detection - Detects if another debugger (IDE) is already listening on the port before starting
• Xdebug config check - Queries Xdebug settings via DBGp feature_get to detect potential configuration issues
• Improved daemon logging - Timestamped log entries for better debugging

Bug Fixes

• Fixed timeout diagnostics to show pending breakpoint commands and last log entries
• Improved error handling for all continuation commands (run, step, next)

Installation

# macOS (Apple Silicon)
curl -L https://github.com/veceravojtech/xdebug-cli/releases/download/v1.0.2/xdebug-cli-darwin-arm64 -o xdebug-cli
chmod +x xdebug-cli
mkdir -p ~/.local/bin
mv xdebug-cli ~/.local/bin/

# Linux (x86_64)
curl -L https://github.com/veceravojtech/xdebug-cli/releases/download/v1.0.2/xdebug-cli-linux-amd64 -o xdebug-cli
chmod +x xdebug-cli
mkdir -p ~/.local/bin
mv xdebug-cli ~/.local/bin/

Note: Make sure ~/.local/bin is in your PATH. Add export PATH="$HOME/.local/bin:$PATH" to your shell profile if needed.

Full Changelog: v1.0.1...v1.0.2

v1.0.1

What's Changed

New Features

• Add attach retry logic with configurable timeout for daemon connections
• Add breakpoint path warning for non-absolute paths with timeout feedback
• Add curl trigger for daemon start (--curl flag with automatic XDEBUG_TRIGGER)
• Add external connection mode (--enable-external-connection flag)
• Add DBGp message timeout handling and XML size validation
• Add registry crash recovery and socket reuse options
• Add breakpoint timeout configuration (--breakpoint-timeout, --wait-forever)

Documentation

• Updated CLAUDE.md and README.md with new features and examples

Internal

• Archived completed OpenSpec changes
• Removed obsolete plan documents and test scripts

xdebug-cli v1.0.0

Initial Release

DBGp protocol client for PHP debugging with Xdebug.

Features

• Daemon-based persistent debug sessions
• TCP server for accepting Xdebug connections
• Full debugging operations: run, step, breakpoints, variable inspection
• Conditional breakpoints with PHP expressions
• Source code display with line numbers
• JSON output mode for automation

Usage

# Start daemon with HTTP trigger
xdebug-cli daemon start --curl "http://localhost/app.php"

# Execute debugging commands
xdebug-cli attach --commands "break :42" "run"

# Stop daemon
xdebug-cli daemon kill