Menu
cmuxターミナル内での操作スキル。CMUX_*環境変数が存在する場合、cmuxのCLIコマンドを使う前に必ずこのスキルを読む。ペイン分割、コマンド送信、ブラウザ自動化、通知、Markdown/diffのプレビュー、cmux設定の変更など、cmux操作全般で使用する。「別ペインで開いて」「横に表示して」「ブラウザで確認して」「プレビューして」「diffを見せて」などのときにも使用する。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
Preview generated Markdown (plans, design notes, reviews, research reports) in the user's browser. Use when sharing long, structured output — documents with headings, tables, code blocks, or Mermaid diagrams — that is hard to read in the terminal.
バグを場当たり修正せず、根本原因を特定してから直すためのデバッグ手順。再現→切り分け→根本原因→検証の順で進める。バグ・デバッグ・原因不明・落ちる・再現しない・CIが赤・flakyなテスト・想定外の挙動に遭遇したときに使用する。「デバッグして」「なぜ落ちる」「原因を調べて」などのときにも使用する。
「完了」「直した」と報告する前に、実際に実行・テスト・観察して根拠を確かめるための検証ルール。修正・実装・リファクタが終わって成功を報告しようとするとき、変更が意図どおり動くと主張する前に使用する。「できた」「直した」「実装した」「修正完了」と言おうとしているときに使用する。
日本語の技術文書を書いた後・公開前にレビューし、重要度つきの指摘レポートを出すスキル（ファイルは変更しない）。日本語の文章品質・AI Slop・表記の慣習・整合性・独自性・語り口を点検する。媒体非依存の汎用版で、ブログMDXなどプロジェクト固有のレビュースキルがあればそちらを優先・併用する。
新しい k8o プロジェクト/リポジトリを立ち上げる一連の手順。@k8o/create で雛形生成 → GitHub リポジトリ作成 → ブランチ保護 ruleset とマージ設定 → リリース用 secret(fnox経由) → npm 初回 publish と Renovate 有効化まで。「新しい repo を作る」「プロジェクトを立ち上げる」「リポジトリの初期設定をする」ときに使用する。
Conventional Commitsに従ったアトミックなgitコミットを作成する。変更を論理単位に分割し、独立してrevert可能なコミットを生成する。コードの変更をコミットしたいとき、コミットメッセージを作りたいときに使用する。
| name | cmux |
| description | cmuxターミナル内での操作スキル。CMUX_*環境変数が存在する場合、cmuxのCLIコマンドを使う前に必ずこのスキルを読む。ペイン分割、コマンド送信、ブラウザ自動化、通知、Markdown/diffのプレビュー、cmux設定の変更など、cmux操作全般で使用する。「別ペインで開いて」「横に表示して」「ブラウザで確認して」「プレビューして」「diffを見せて」などのときにも使用する。 |
cmuxはAIコーディングエージェント向けのmacOSネイティブターミナル。CMUX_SOCKET_PATHかCMUX_WORKSPACE_IDが設定されていればcmux内で実行中。CLIはcmuxが自セッションのPATHに自動で通している。
cmux identify --json # 現在の位置（window, workspace, pane, surface）
cmux tree # トポロジー全体
cmux capabilities # このバージョンで使える機能
階層: Window → Workspace（サイドバータブ） → Pane（分割） → Surface（ペイン内のタブ。ターミナル/ブラウザ）
Ref形式: workspace:2, pane:1, surface:7（UUIDより優先して使う）。フラグ省略時はCMUX_WORKSPACE_ID / CMUX_SURFACE_ID（＝呼び出し元）がデフォルトになる。
ユーザーは別のworkspaceや別アプリを見ていることがある。フォーカスを奪う操作はクリックと同等のユーザー操作なので、明示的に頼まれない限り呼ばない: select-workspace / focus-pane / focus-panel。
レイアウトは1コマンドで完結させ、--focus falseが使えるコマンドでは必ず付ける:
# ペイン作成と中身の指定を1回で行う（作ってから移動・フォーカスの連鎖をしない）
cmux new-pane --type terminal --direction down --focus false
cmux new-pane --type browser --direction right --url http://localhost:3000 --focus false
# 既に補助ペインがあるなら、ペインを増やさずそこにsurfaceを足す
cmux list-panes --json
cmux new-surface --pane pane:2 --type terminal --focus false
補助的な出力（プレビュー、ログ、一時シェル）は呼び出し元の右隣の補助ペイン1つに集約し、繰り返しの「開いて」はそのペインのタブとして追加する。
長時間タスクやサブエージェントの隔離実行に使う。数秒で終わるコマンドには不要。
cmux send --surface surface:5 "command\n" # \nで実行される
cmux send-key --surface surface:5 <key>
cmux read-screen --surface surface:5 --lines 50 # --scrollbackで履歴も読む
基本フロー: open → get urlで確認 → wait → snapshot（ref取得） → refで操作 → 再snapshot
cmux --json browser open https://example.com # 返ってきたsurface refを以後使う
cmux browser surface:7 get url # 空/about:blankならwaitせず先にnavigate
cmux browser surface:7 wait --load-state complete --timeout-ms 15000
cmux browser surface:7 snapshot --interactive # 常に--interactiveでelement refを取得
cmux browser surface:7 click e2 --snapshot-after
cmux browser surface:7 fill e3 "text" # 空文字でクリア
cmux browser surface:7 select e7 "value"
cmux browser surface:7 press Enter
cmux browser surface:7 wait --selector "#loaded" --timeout-ms 10000
cmux browser surface:7 wait --text "Success"
cmux browser surface:7 wait --url-contains "/dashboard"
cmux browser surface:7 get text e3
cmux browser surface:7 eval 'document.title'
cmux browser surface:7 screenshot --out shot.png
snapshot --interactiveやevalがjs_errorを返すページではget text body / get html bodyにフォールバックする。not_supported。高レベルコマンド（click/fill/wait/snapshot）で代替する。計画やレポートをターミナル横に整形表示する。ファイル変更で自動再描画されるため、進捗を追記していく使い方ができる。
cmux markdown open plan.md
git diffやパッチを専用ビューアのペインで開く。ユーザーは変更行にレビューコメントを付けてTextBox経由でエージェントに渡せるので、変更を見せてフィードバックをもらう場面で使う。
cmux diff # リポジトリのdiffを開く（ベースはスマート推定）
git diff main... | cmux diff # 任意のパッチをstdinから渡す
cmux diff --layout split # unified | split
| 用途 | コマンド |
|---|---|
| cmux内の通知（ペインリング） | cmux notify --title "T" --body "B" |
| システム通知（他アプリにいるとき） | osascript -e 'display notification "B" with title "T"' |
| 注意を引くフラッシュ | cmux trigger-flash --surface surface:7 |
長時間タスクではサイドバーに進捗を出せる:
cmux set-status build "compiling" --color "#5eead4"
cmux set-progress 0.4 --label "3/7 done"
cmux log --level info -- "step 3 finished"
cmux clear-status build && cmux clear-progress
~/.config/ghostty/config~/.config/cmux/cmux.json（JSONC可）dot_config/ghostty/configとdot_config/cmux/cmux.json）。~/.configを直接編集するとchezmoi applyで戻るので、dotfiles側を編集して適用する。cmux reload-configでも両方を再読込できる）。アプリの再起動は不要。cmux docs settingsが出力する。