macdbg-agent

Debug macOS binaries headlessly via JSON commands using macdbg and LLDB.

7|1|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/MZHeader/macdbg --skill macdbg-agent
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: macdbg-agent
Source: https://github.com/MZHeader/macdbg/tree/main/.claude/skills/macdbg-agent
Command: npx skills add https://github.com/MZHeader/macdbg --skill macdbg-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The macdbg-agent Skill solves the problem of manually debugging macOS binaries by providing a headless debugging capability. It allows you to launch/attach a macOS binary, set breakpoints, step, read/write memory and registers, and toggle anti-anti-debug bypasses all via JSON commands.

Core Features & Use Cases

  • Headless Debugging: Debugging without the need for a GUI, ideal for automated or server-side debugging scenarios.
  • LLDB Integration: Utilizes LLDB for debugging, ensuring robustness and wide functionality.
  • JSON Commands: Interacts through a JSON protocol, making it suitable for integration with other tools or services.
  • Use Case: When you need to debug a macOS binary programmatically or integrate debugging into an automated workflow.

Quick Start

Start a debugging session with the macdbg-agent by running: ./agent.sh start --session <name> --attach <pid> <program>

Frequently Asked Questions about macdbg-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a macOS binary without a GUI in an automated workflow?▼

Headless debugging of macOS binaries allows you to launch or attach to processes without a GUI. You can use the macdbg-agent to interact via JSON commands, making it ideal for automated or server-side debugging scenarios.

Can I set breakpoints and step through code programmatically on macOS?▼

Yes, you can set breakpoints and step through code programmatically. The macdbg-agent utilizes LLDB to automate tasks such as launching processes, setting breakpoints, and stepping through code via JSON commands.

Does LLDB support reading and writing memory during headless debugging?▼

Yes, LLDB supports reading and writing memory during headless debugging. The macdbg-agent allows you to read and write memory and registers, and toggle anti-anti-debug bypasses through a JSON protocol.

What is the best way to automate server-side debugging for macOS executables?▼

The best way to automate server-side debugging for macOS executables is using a JSON-based headless debugger. The macdbg-agent integrates with LLDB to automate process attachment, memory manipulation, and execution control.

How do I bypass anti-debugging techniques when analyzing a macOS binary?▼

To bypass anti-debugging techniques when analyzing a macOS binary, you can use a headless debugger that toggles anti-anti-debug bypasses. The macdbg-agent provides this capability through its JSON command interface.

Can I attach to an existing process for macOS binary analysis in a non-interactive environment?▼

Yes, you can attach to an existing process for macOS binary analysis in a non-interactive environment. Use the command `./agent.sh start --session <name> --attach <pid> <program>` to initiate a headless debugging session.