debug-menu

Generate a debug menu for iOS and macOS DEBUG builds.

603|51|Updated Oct 29, 2025
One-click install
npx skills add https://github.com/rshankras/claude-code-apple-skills --skill debug-menu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-menu
Source: https://github.com/rshankras/claude-code-apple-skills/tree/main/skills/generators/debug-menu
Command: npx skills add https://github.com/rshankras/claude-code-apple-skills --skill debug-menu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive in-app menu for developers to access debugging tools, toggle features, and gather diagnostic information, all while ensuring it's excluded from production builds.

Core Features & Use Cases

  • In-App Dev Tools: Access feature flags, environment switching, network logs, cache clearing, and crash simulation.
  • Developer Experience: Streamlines debugging and testing workflows directly within the running application.
  • Use Case: A developer needs to test how their app behaves in different network environments or toggle a new feature flag without recompiling. They activate the debug menu to make these changes instantly.

Quick Start

Generate a developer debug menu with feature flag toggles and environment switching.

Frequently Asked Questions about debug-menu

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

FAQPage Schema
How do I add an in-app debug menu for iOS and macOS applications?

To add an in-app debug menu for iOS and macOS, generate a developer menu with feature flag toggles, environment switching, and network log viewing. This menu is designed for DEBUG builds only, ensuring no debugging code ships to production.

Can I simulate crashes and clear cache directly within a running macOS app?

Yes, you can simulate crashes and clear cache directly within a running macOS or iOS app. The debug menu includes cache clearing and crash simulation tools, allowing developers to test error handling and app recovery workflows without recompiling.

What is the best way to toggle feature flags during iOS app development?

The best way to toggle feature flags during iOS app development is through an in-app debug menu. It provides instant toggles for new features, allowing developers to test different states and behaviors directly within the running application.

Does the debug menu avoid shipping developer tools in production iOS builds?

Yes, the debug menu avoids shipping developer tools in production iOS builds. It is explicitly designed to be included only in DEBUG builds, ensuring all diagnostic information export and environment switching features remain internal.

How do I test different network environments in an iOS app without recompiling?

To test different network environments in an iOS app without recompiling, use the debug menu's environment switching feature. Developers can activate the menu to instantly change environments and view network logs during testing.

What diagnostic information can I export from a macOS debug menu?

From a macOS debug menu, you can export diagnostic information including network logs and crash simulation data. This allows developers to gather comprehensive in-app diagnostic details to streamline debugging and testing workflows.