cmux-debugging — скилл для Claude Code: отладка UI и терминала
Скилл для добавления отладочных логов, диагностики проблем UI и рантайма в cmux. Пригодится, когда вы работаете с терминальным рендерингом, списками вкладок, drag-and-drop или тестируете на разных версиях macOS.
npx skills add manaflow-ai/cmux --skill cmux-debugging -a claude-codeЧто делает cmux-debugging
cmux-debugging предоставляет инструменты для отладки: унифицированный лог событий (клавиши, мышь, фокус, сплиты, вкладки), Debug меню в macOS и справочник частых ошибок рантайма. Логи пишутся в /tmp/cmux-debug.log (или в файл с тегом), можно смотреть в реальном времени через tail -f. Для профилирования используйте xctrace record --attach на пид вашего процесса — но никогда не запускайте профайлер через launch mode.
Внутри скилла — документация по стабильным префиксам событий (focus.panel, tab.select, pane.drop), описание Debug меню (добавляйте свои панели через NSWindowController), и набор runtime pitfalls: как работает TabItemView с Equatable, почему TerminalSurface.forceRefresh() должна быть без аллокаций, как устроены снимки состояния за границами LazyVStack и List. Все вызовы логирования обёрнуты в #if DEBUG, так что в боевой сборке их нет.
Проверяйте ваши изменения на той же версии macOS, на которой нашли багу: поведение Foundation, SwiftUI и WebKit отличается между мажорными версиями.
Какие задачи решает
- добавить отладочный логи для событий (клавиши, мышь, фокус)
- диагностировать проблемы с UI и рантаймом
- отследить поведение при работе с терминальным рендерингом
- проверить работу drag-and-drop и кастомных UTTypes
- профилировать производительность на разных версиях macOS
Примеры запросов агенту
- Добавь отладочный логи для событий клавиатуры в `performKeyEquivalent`
- Помоги мне диагностировать задержку при вводе текста в терминал
- Объясни, почему `TabItemView` требует обновления оператора `==` при изменении окружения
Как установить cmux-debugging
1Через Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-debugging -a claude-code2Вручную: положить файлы
~/.claude/skills/cmux-debugging/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cmux-debugging/
1Через Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-debugging -a codex2Вручную: положить файлы
.agents/skills/cmux-debugging/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-debugging -a cursor2Вручную: положить файлы
.cursor/skills/cmux-debugging/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install manaflow-ai/cmux cmux-debugging2Вручную: положить файлы
.github/skills/cmux-debugging/SKILL.md1Через Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-debugging -a gemini-cli2Командой платформы
gemini skills install https://github.com/manaflow-ai/cmux --path skills/cmux-debuggingВручную: положить файлы
.devin/skills/cmux-debugging/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-debugging -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора12
Весь набор →Похожие
Вопросы о cmux-debugging
Как установить cmux-debugging в Claude Code?
Выполни npx skills add manaflow-ai/cmux --skill cmux-debugging -a claude-code, затем открой ~/.claude/skills/cmux-debugging/SKILL.md.
Что делает cmux-debugging?
Предоставляет инструменты для отладки cmux: логирование событий UI в унифицированный лог, Debug меню в macOS и справочник частых ошибок при работе с терминальным рендерингом, списками и состоянием SwiftUI.
Где находятся отладочные логи?
По умолчанию в /tmp/cmux-debug.log; если вы используете теговую сборку (./scripts/reload.sh --tag <tag>), логи идут в /tmp/cmux-debug-<tag>.log. Смотреть в реальном времени: tail -f "$(cat /tmp/cmux-last-debug-log-path 2>/dev/null || echo /tmp/cmux-debug.log)".
