manaflow-ai/cmux-diagnostics

エンドユーザーのcmux診断を実行します。cmuxフック、通知、セッション復元、設定、ブラウザ自動化、ソケットアクセス、CLI制御、エージェント再開動作が機能しない場合や、ユーザーがcmuxヘルスチェック、ドクターレポート、サポート向けデバッグサマリーを要求した場合に使用します。

cmux-diagnostics とは?

このスキルは、cmux(Claude Codeのマルチプレクサ拡張)に関する問題を診断・トラブルシューティングするためのものです。cmuxフックの実行失敗、セッション復元の問題、ブラウザ自動化の停止、CLI制御の不具合など、特定の症状に対して使用します。また、包括的なヘルスチェックやサポート向けのデバッグ情報を提供する「ドクターレポート」も生成できます。cmuxの設定や環境変数(CMUX_HOME、CMUX_ENV、CMUX_AGENT、CMUX_AUTHなど)を確認し、ソケットアクセスや実行権限を検証して、問題の原因を特定します。Agents SDK、Claude Code、Cursor、Codexといった複数のプラットフォームで動作し、開発者がcmux関連の問題を効率的にデバッグできるよう支援します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-diagnostics

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

cmux-diagnostics は何をしますか?

エンドユーザーのcmux診断を実行します。cmuxフック、通知、セッション復元、設定、ブラウザ自動化、ソケットアクセス、CLI制御、エージェント再開動作が機能しない場合や、ユーザーがcmuxヘルスチェック、ドクターレポート、サポート向けデバッグサマリーを要求した場合に使用します。

使用方法

以下のような状況でこの診断スキルを呼び出します:

  • cmuxフックが実行されない
  • 通知が届かない
  • セッションが正しく復元されない
  • 設定が適用されない
  • ブラウザ自動化が動作しない
  • ソケットアクセスに問題がある
  • CLI制御が応答しない
  • エージェント再開動作に問題がある
  • ユーザーが「cmuxヘルスチェック」や「ドクターレポート」を要求した

診断内容

この診断スキルは以下の項目をチェックします:

  1. 環境変数: CMUX_HOME、CMUX_ENV、CMUX_AGENT、CMUX_AUTH などの設定状態
  2. ソケットアクセス: cmuxソケットが利用可能かどうか
  3. 実行権限: 必要な権限が正しく設定されているか
  4. 設定ファイル: cmux設定ファイルの整合性
  5. フックスクリプト: フックスクリプトの存在と実行可能性
  6. ログ: cmuxのログにエラーや警告がないか

出力

診断結果は以下の形式で返されます:

  • 各チェック項目のステータス(OK/WARNING/ERROR)
  • 問題が見つかった場合の詳細な説明
  • 推奨される修正手順
  • サポート向けのデバッグサマリー(必要な場合)

注意事項

  • 診断は非破壊的で、システムに変更を加えません
  • 機密情報がログに含まれる可能性があるため、サポート向けサマリーを共有する際は注意してください
  • 問題が解決しない場合は、cmuxの公式ドキュメントを参照するか、サポートチームに連絡してください

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

manaflow-ai/cmux

End-user control of cmux topology and routing (windows, workspaces, panes/surfaces, focus, moves, reorder, identify, trigger flash). Use when automation needs deterministic placement and navigation in a multi-pane cmux layout.

manaflow-ai/cmux-browser

End-user browser automation with cmux. Use when you need to open sites, interact with pages, wait for state changes, and extract data from cmux browser surfaces.

manaflow-ai/cmux-customization

Customize cmux for an end user. Use when changing cmux.json actions, custom commands, workspace layouts, plus-button behavior, surface tab bar buttons, Command Palette entries, Dock controls, sidebar and app settings, shortcuts, notifications, browser routing, examples-library presets, or Ghostty-backed terminal preferences.

manaflow-ai/cmux-markdown

Open markdown files in a formatted viewer panel with live reload. Use when you need to display plans, documentation, or notes alongside the terminal with rich rendering (headings, code blocks, tables, lists).

manaflow-ai/cmux-settings

View and edit cmux settings in ~/.config/cmux/cmux.json. Use when the user wants to change cmux preferences (appearance, sidebar, notifications, automation, browser, shortcuts), set a value by JSON path, validate the file, open it in an editor, or look up which keys cmux recognizes. Triggers on '/cmux-settings', 'change cmux setting', 'set <something> in cmux', 'cmux config', 'cmux.json', or 'rebind a cmux shortcut'.

manaflow-ai/cmux-workspace

Work inside the current cmux workspace and terminal. Use for cmux workspace, current workspace, caller surface, panes, surfaces, socket targeting, and non-interfering cmux automation.

関連スキル