cmux调试窗口使用指南 - macOS调试菜单与窗口管理工具

cmux-debug-windows by manaflow-ai/cmux

247 周安装量

10,100 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/manaflow-ai/cmux --skill cmux-debug-windows

开发 macOS Swift

🇨🇳中文介绍

cmux 调试窗口

请保持此工作流专注于现有的调试窗口和菜单项。除非用户明确要求，否则不要添加新的实用工具/调试控制窗口。

工作流程

在 Sources/cmuxApp.swift 文件中的 CommandMenu("Debug") 下验证调试菜单的配置。
- 应用程序中的菜单路径：调试 → 调试窗口 → 窗口项。
- 调试 菜单仅在 DEBUG 构建中（./scripts/reload.sh --tag ...）存在。
- 发布版本构建（reloadp.sh、reloads.sh）不会显示此菜单。
在 菜单("调试窗口") 中保持以下操作可用：

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

776,000 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

261,300 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

210,800 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

140,500 周安装

侧边栏调试…
后台调试…
菜单栏扩展调试…
打开所有调试窗口

在添加新 UI 之前，请重用每个调试窗口中现有的逐窗口复制按钮（复制配置）。
要获取一个组合的配置快照，请运行：

skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh --copy

代码编辑后，运行构建 + 带标签的重载：

xcodebuild -project GhosttyTabs.xcodeproj -scheme cmux -configuration Debug -destination 'platform=macOS' build

./scripts/reload.sh --tag <tag>

Sources/cmuxApp.swift：调试菜单项和调试窗口控制器/视图。
Sources/AppDelegate.swift：菜单栏扩展调试设置的有效负载和默认值键。

scripts/debug_windows_snapshot.sh

读取当前与调试相关的默认值。
打印侧边栏/后台/菜单栏扩展的组合快照。
可选择将其复制到剪贴板。

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

🇺🇸English

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

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.
Keep these actions available in Menu("Debug Windows"):

Sidebar Debug…
Background Debug…
Menu Bar Extra Debug…
Open All Debug Windows

Reuse existing per-window copy buttons (Copy Config) in each debug window before adding new UI.
For one combined payload, run:

skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh --copy

After code edits, run build + tagged reload:

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:

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

Weekly Installs

247

Repository

manaflow-ai/cmux

GitHub Stars

10.1K

First Seen

Feb 21, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

codex239

cursor239

amp238

gemini-cli238

kimi-cli238

opencode238

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

106,200 周安装