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.