| name | cursor-collab |
| description | Chat with Cursor Agent via tmux for pair programming. Use when user wants to collaborate with Cursor, get second opinion, design consultation, or code review. |
| version | 1.2.0 |
Cursor Agent Chat
Claude Code と Cursor Agent が tmux でチャットするスキル。
前提条件(実行前に確認)
- tmux セッション内で実行すること(
tmux コマンドが動作する環境)
cursor-agent CLI がインストール済み
- Cursor Agent 認証済み
役割分担(重要)
| AI | 役割 | 担当タスク |
|---|
| Claude Code | 実装担当 | コード作成・編集・ファイル操作・テスト実行 |
| Cursor Agent | 相談役 | 設計相談・レビュー・セカンドオピニオン・質問回答 |
Cursor Agent に実装を依頼しないこと。 Cursor Agent から設計提案やレビューを受けて、Claude Code が実装する。
セットアップ
Cursor Agent ペイン作成
現在のウィンドウを水平分割し、右側ペインで Cursor Agent を起動:
tmux split-window -h
tmux send-keys "cursor-agent"
tmux send-keys Enter
split-window -h: 水平分割(左右に分かれる)
- 新しいペインがアクティブになるが、Claude Code は元のペインで継続
- 重要:
tmux send-keys は && で連結せず、別々の Bash コマンドとして実行すること
sleep && tmux capture-pane のような組み合わせは OK
ペイン番号の確認
tmux list-panes -F "#{pane_index}: #{pane_current_command}"
通常、Claude Code が pane 0 または 1、Cursor Agent が pane 1 または 2 になる。
注意: 以降の例では :.1 を使用しているが、実際のペイン番号は list-panes の結果に合わせて置換すること。
チャット
Cursor Agent に質問
tmux send-keys -t :.1 "質問内容"
tmux send-keys -t :.1 Enter
-t :.1: 現在のウィンドウのペイン 1 を指定(環境に応じて変更)
- 重要: テキスト送信と Enter 送信は別々の Bash コマンドとして実行
&& で連結すると Enter が送信されないことがある
Cursor Agent の返信を確認(待機付き)
sleep 30 && tmux capture-pane -t :.1 -p -S -100
-S -100: スクロールバッファから過去100行を取得
- 応答が長い場合は
sleep の秒数を増やす
- 処理中表示がある場合は追加で待機する
Cursor Agent ペイン終了
tmux kill-pane -t :.1
ワークフロー
/cursor-collab でペイン作成・Cursor Agent 起動
- Cursor Agent に相談・質問を送信
- 返信を確認(sleep で待機)
- Cursor Agent の提案を受けて Claude Code が実装
- 必要に応じて Cursor Agent にレビュー依頼
- ペイン終了
使用例
設計相談 → Claude Code が実装
User: "Cursor Agent と認証機能について相談したい"
Claude:
1. Cursor Agent ペイン作成(3つの Bash コマンドを順番に実行)
Bash(tmux split-window -h)
Bash(tmux send-keys "cursor-agent")
Bash(tmux send-keys Enter)
Bash(sleep 5) # Cursor Agent 起動待ち
2. Cursor Agent に設計相談(2つの Bash コマンドを順番に実行)
Bash(tmux send-keys -t :.1 "JWT vs セッションベース認証、どちらを推奨しますか?理由も教えて")
Bash(tmux send-keys -t :.1 Enter)
3. 返信を確認(待機後にキャプチャ)
Bash(sleep 30)
Bash(tmux capture-pane -t :.1 -p -S -100)
4. Cursor Agent の提案を受けて Claude Code が実装
Write/Edit ツールでコード作成
5. 実装後、Cursor Agent にレビュー依頼(2つの Bash コマンドを順番に実行)
Bash(tmux send-keys -t :.1 "この実装をレビューして: [コード概要]")
Bash(tmux send-keys -t :.1 Enter)
6. 終了(ペインのみ閉じる)
Bash(tmux kill-pane -t :.1)
Cursor Agent への適切な質問例
- 「この設計アプローチについてどう思う?」
- 「AとBどちらのパターンを推奨する?」
- 「この実装のセキュリティリスクは?」
- 「パフォーマンス改善のアイデアある?」
- 「このコードをレビューして」
不適切な依頼例(避けること)
- 「このコードを実装して」
- 「ファイルを作成して」
- 「テストを書いて」
注意事項
- 非対話モード(ヘッドレス)は使わない。対話 UI で運用すること
- ペインでインタラクティブモードを使用(バックグラウンドではない)
- 処理中表示がある場合は追加で待機が必要
tmux send-keys は && で連結しないこと:
- 各
tmux send-keys は個別の Bash コマンドとして実行する
- 注:
sleep && tmux capture-pane のような非 send-keys コマンドの連結は問題ない
長い質問をファイル経由で送信
cat > /tmp/question.txt << 'EOF'
ここに長い質問を書く。
複数行でも可。
EOF
tmux load-buffer -b cursor_q /tmp/question.txt
tmux paste-buffer -t :.1 -b cursor_q -d
tmux send-keys -t :.1 Enter
待機時間・リカバリー
待機時間の目安、ポーリング戦略、タイムアウト時の対応、リカバリー手順は共通ガイドを参照:
参照: skills/tmux-ai-chat/references/recovery-guide.md