view --main cmux-debug-windows-upravlenie-oknami-otladki-dlya-ghostty.md

cmux-debug-windows — Управление окнами отладки для Ghostty

Name: cmux-debug-windows — Управление окнами отладки для Ghostty
Author: manaflow-ai/cmux

cmux-debug-windows расширяет функциональность эмулятора терминала Ghostty, предлагая удобное управление окнами отладки, оптимизированное для работы с AI-агентами и упрощающее процесс геймдев. Решение позволяет разработчикам эффективно настраивать и отлаживать сложные системы, особенно актуально при разработке игр и использовании современных игровых движков.

Модуль обеспечивает управление существующими окнами отладки через меню "Debug Windows" в Ghostty (доступно только в DEBUG сборках). Ключевые функции включают в себя: "Sidebar Debug…", "Background Debug…", "Menu Bar Extra Debug…" и "Open All Debug Windows", а также переиспользование существующих кнопок "Copy Config" для удобной настройки. Используется Swift и интегрирован с macOS и Bash.

Для удобства настройки и сохранения конфигурации отладочных окон доступен Snapshot Script (debug_windows_snapshot.sh), позволяющий создавать и копировать конфигурационные файлы. Интеграция с AI-агентами обеспечивает плавный и продуктивный рабочий процесс в геймдев и других областях, требующих глубокой отладки. Для обновления требуется сборка и перезагрузка с тегом.

$ git log --oneline --stat

⭐ звёзды: 11,290

форки: 783

обновлено: 28 марта 2026 года в 22:15

Проводник файлов

1 файлы

SKILL.md

readonly --- lines

--- name: cmux-debug-windows description: Manage cmux debug windows and related debug menu wiring for Sidebar Debug, Background Debug, and Menu Bar Extra Debug. Use this when the user asks to open/tune these debug controls, add or adjust Debug menu entries, or capture/copy a combined debug config snapshot. --- # cmux Debug Windows Keep this workflow focused on existing debug windows and menu entries. Do not add a new utility/debug control window unless the user asks explicitly. ## Workflow 1. Verify debug menu wiring in `Sources/cmuxApp.swift` under `CommandMenu("Debug")`. - Menu path in app: `Debug` → `Debug Windows` → window entry. - The `Debug` menu only exists in DEBUG builds (`./scripts/reload.sh --tag ...`). - Release builds (`reloadp.sh`, `reloads.sh`) do not show this menu. 2. Keep these actions available in `Menu("Debug Windows")`: - `Sidebar Debug…` - `Background Debug…` - `Menu Bar Extra Debug…` - `Open All Debug Windows` 3. Reuse existing per-window copy buttons (`Copy Config`) in each debug window before adding new UI. 4. For one combined payload, run: ```bash skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh --copy ``` 5. After code edits, run build + tagged reload: ```bash xcodebuild -project GhosttyTabs.xcodeproj -scheme cmux -configuration Debug -destination 'platform=macOS' build ./scripts/reload.sh --tag <tag> ``` ## Key Files - `Sources/cmuxApp.swift`: Debug menu entries and debug window controllers/views. - `Sources/AppDelegate.swift`: Menu bar extra debug settings payload and defaults keys. ## Script - `scripts/debug_windows_snapshot.sh` Purpose: - Reads current debug-related defaults values. - Prints one combined snapshot for sidebar/background/menu bar extra. - Optionally copies it to clipboard. Examples: ```bash skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh --copy skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh --domain <bundle-id> --copy ```

Инициализация мануала...