cmux 公式スキル徹底解説 — ターミナル制御・ブラウザ自動化・Markdown ビューアの3本柱

# 自分の現在位置を確認
cmux identify --json
 
# トポロジーの一覧取得
cmux list-windows
cmux list-workspaces
cmux list-panes
cmux list-pane-surfaces --pane pane:1

# 新しいワークスペースを作成（プロジェクト単位の切り替えに）
cmux new-workspace
 
# ペインを分割（右に新しいターミナルを開く）
cmux new-split right --panel pane:1
 
# サーフェスを別のペインに移動
cmux move-surface --surface surface:7 --pane pane:2 --focus true
 
# ワークスペースの並び替え
cmux reorder-workspace --workspace workspace:4 --before workspace:2

# 特定のサーフェスを視覚的にフラッシュ（注意を引く）
cmux trigger-flash --surface surface:7
 
# サーフェスの状態をチェック（隠れていないか、切り離されていないか）
cmux surface-health --workspace workspace:2

# 1. ブラウザを開く
cmux --json browser open https://example.com
 
# 2. ページ読み込みを待機
cmux browser surface:7 wait --load-state complete --timeout-ms 15000
 
# 3. スナップショットで要素参照を取得
cmux browser surface:7 snapshot --interactive
 
# 4. refs で直接操作
cmux browser surface:7 fill e1 "hello"
cmux --json browser surface:7 click e2 --snapshot-after
 
# 5. 操作後に再スナップショット（refs は DOM 変更で無効化される）
cmux browser surface:7 snapshot --interactive

# サインアップフォームを自動入力
cmux --json browser open https://example.com/signup
cmux browser surface:7 wait --load-state complete --timeout-ms 15000
cmux browser surface:7 snapshot --interactive
cmux browser surface:7 fill e1 "Jane Doe"
cmux browser surface:7 fill e2 "jane@example.com"
cmux --json browser surface:7 click e3 --snapshot-after
cmux browser surface:7 wait --url-contains "/welcome" --timeout-ms 15000

# CSS セレクタで要素出現を待機
cmux browser surface:7 wait --selector "#ready" --timeout-ms 10000
 
# テキスト出現を待機
cmux browser surface:7 wait --text "Success" --timeout-ms 10000
 
# URL 変化を待機
cmux browser surface:7 wait --url-contains "/dashboard" --timeout-ms 10000
 
# JavaScript 条件で待機
cmux browser surface:7 wait --function "document.readyState === 'complete'" --timeout-ms 10000

# クリック後に自動で snapshot を取り直す
cmux --json browser surface:7 click e5 --snapshot-after

# Markdown ファイルをビューアで開く
cmux markdown open plan.md
 
# 特定のワークスペースで開く
cmux markdown open design.md --workspace workspace:2

# タスクリストを作成
cat > plan.md << 'EOF'
# タスクリスト
## Steps
1. コードベースを分析
2. 機能を実装
3. テストを書く
4. ビルドを確認
EOF
 
# ビューアで開く
cmux markdown open plan.md
 
# AI が進捗を更新 → ビューアが自動で反映
echo "## Step 1: Complete ✅" >> plan.md

# 実装タスク
 
## Phase 1: セットアップ
- [x] プロジェクト初期化
- [x] 依存関係インストール
 
## Phase 2: 実装
- [x] API エンドポイント作成
- [ ] フロントエンド実装 ← 今ここ
- [ ] テスト作成

## Plan Display
タスクに着手する前に計画を .md ファイルに書き出し、cmux で開いてください:
    cmux markdown open plan.md
タスクの完了ごとにチェックボックスを更新してください。
ビューアはファイル変更を自動検知してリアルタイム更新されます。

# 1. コアスキル: レイアウトを準備
cmux new-split right --panel pane:1    # 右にペインを追加
 
# 2. Markdown スキル: タスクリストを表示
cmux markdown open tasks.md            # 左にタスクリスト
 
# 3. ブラウザスキル: 開発サーバーのプレビュー
cmux browser open http://localhost:3000  # 右にブラウザ
 
# 4. AI がコードを修正 → ブラウザで確認 → タスクリスト更新
# すべてが cmux の中で完結する