Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

cmux-debugging — Claude Code skill: debug UI and terminal rendering

Skill for adding debug logging, diagnosing UI and runtime issues in cmux. Use when working with terminal rendering, tab lists, drag-and-drop, or testing across macOS versions.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add manaflow-ai/cmux --skill cmux-debugging -a claude-code
Open on GitHub

What cmux-debugging does

cmux-debugging provides debugging tools: a unified event log (keys, mouse, focus, splits, tabs), Debug menu in macOS, and a reference for common runtime pitfalls. Logs write to /tmp/cmux-debug.log (or a tagged file), and you can tail them in real time. For profiling, use xctrace record --attach on your process PID—but never launch the profiler via launch mode.

The skill includes documentation on stable event prefixes (focus.panel, tab.select, pane.drop), how to add custom Debug menu panels via NSWindowController, and runtime pitfalls: how TabItemView uses Equatable to skip re-evaluation during typing, why TerminalSurface.forceRefresh() must avoid allocations, how snapshot boundaries work in LazyVStack and List. All logging calls are wrapped in #if DEBUG, so they vanish from release builds.

Test your changes on the same macOS version where the bug was found: Foundation, SwiftUI, and WebKit behaviour differs across major versions.

What it helps with

  • add debug logging for UI events (keys, mouse, focus)
  • diagnose UI and runtime issues
  • trace terminal rendering behaviour
  • verify drag-and-drop and custom UTType handling
  • profile performance across macOS versions

Example prompts for the agent

  • Add debug logging for keyboard events in `performKeyEquivalent`
  • Help me diagnose typing latency in the terminal
  • Explain why `TabItemView` requires updating the `==` operator when environment changes

How to install cmux-debugging

1Skills CLI (Vercel)

npx skills add manaflow-ai/cmux --skill cmux-debugging -a claude-code

2Manually: put the files in place

~/.claude/skills/cmux-debugging/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cmux-debugging/

From the same set12

The whole set →
cmux manaflow-ai Skill for navigating multi-pane cmux layouts: create windows, workspaces, splits, focus surfaces, and move terminals and browser panels without breaking automation. Use it when an agent needs deterministic placement and routing. Claude Code CX Codex Cursor +1 9,600installs cmux-browser manaflow-ai Automates browser surfaces via the cmux CLI without stealing user focus. Useful for background page inspections, waiting on selectors, and form fills. Claude Code CX Codex Cursor +1 8,800installs cmux-customization manaflow-ai Configures the cmux workspace manager: edits cmux.json, wires Command Palette actions, sets dock terminals, and routes terminal-level styling directly to Ghostty. Claude Code CX Codex Cursor +1 6,600installs cmux-diagnostics manaflow-ai Skill runs read-only cmux diagnostics: sockets, hooks, session restore, settings. Use when notifications fail, agents don't resume, or you need a support-safe debug report. Claude Code CX Codex Cursor +1 6,400installs cmux-keyboard-shortcuts manaflow-ai Configures cmux shortcuts in ~/.config/cmux/cmux.json. Useful for adopting tmux-style chords, auditing overrides, and validating syntax. Claude Code CX Codex Cursor +1 6,200installs cmux-testing manaflow-ai Skill for choosing verification scopes, adding tests, and validating Swift test targets in the cmux project. Decides what local and CI evidence a change needs. Claude Code CX Codex Cursor +1 4,900installs cmux-custom-sidebar manaflow-ai Skill for writing a custom cmux sidebar in a SwiftUI-like language. The sidebar binds to workspaces, tabs, PRs, and clock; hot-reloads on save; runs cmux commands on tap. Claude Code CX Codex Cursor +1 4,800installs cmux-architecture manaflow-ai Guides modular Swift package architecture, strict 5-layer dependency inversion, and Swift 6 concurrency rules in the cmux codebase. Claude Code CX Codex Cursor +1 4,800installs

Similar

seo-images AgriciDaniel Checks alt text, file size, format (WebP/AVIF), responsive images, lazy loading, and metadata. Flags CLS issues and shows how many kilobytes you can save. Claude Code CX Codex Cursor +1 6,700installs agentation-self-driving benjitaylor Runs autonomous design critiques in a visible browser window and leaves feedback notes directly through the Agentation toolbar. Claude Code CX Codex Cursor +1 7,000installs argent-react-native-optimization software-mansion Profiles React Native apps to pinpoint runtime bottlenecks and fixes mechanical code issues. It steps in when user screens stutter, startup lags, or re-renders spike. Claude Code CX Codex Cursor +1 26,400installs d3-visualization nexu-io This skill teaches the agent to create interactive D3.js visualizations. Use it to generate charts for dashboards, reports, and data-rich prototypes. Claude Code CX Codex Cursor +1 3,100installs design-review nexu-io Audits UI visually, fixes flaws with atomic commits, and captures before/after screenshots. Useful for tightening shipped interface code right before launch. Claude Code CX Codex Cursor +1 3,100installs frontend-design official anthropics This skill guides intentional visual design for new interfaces and redesigns. Use it when a generic generated UI is not enough. Claude Code Claude.ai 1,025,790installs design-taste-frontend Leonxlnx This skill directs the design of public pages and work screens, then checks the result in a browser through screenshots. Use it when an interface feels generic or unfinished. Claude Code CX Codex Cursor +1 673,100installs prototype Matt Pocock Creates throwaway prototypes for checking state logic or exploring UI before committing the decision to the main codebase. Claude Code 986,201installs

Questions about cmux-debugging

How do I install cmux-debugging in Claude Code?

Run npx skills add manaflow-ai/cmux --skill cmux-debugging -a claude-code, then open ~/.claude/skills/cmux-debugging/SKILL.md.

What does cmux-debugging do?

Provides debugging tools for cmux: unified event logging (keys, mouse, focus, splits, tabs), a Debug menu in macOS, and reference documentation for common runtime pitfalls in terminal rendering, list virtualization, and SwiftUI state.

Where are the debug logs stored?

By default in /tmp/cmux-debug.log; if you use a tagged build (./scripts/reload.sh --tag <tag>), logs go to /tmp/cmux-debug-<tag>.log. Tail them in real time: tail -f "$(cat /tmp/cmux-last-debug-log-path 2>/dev/null || echo /tmp/cmux-debug.log)".

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor