Skill

ccwire-protocol

CC間通信プロトコル。複数のClaude Codeセッション間でリアルタイムにメッセージをやり取りする。wire_register, wire_send, wire_receive等のMCPツールでセッション登録・メッセージ送受信を行う。

Install

npx claudepluginhub chronista-club/claude-plugins --plugin ccwire

Tool Access

This skill uses the workspace's default tool permissions.

Preview

CC間通信プロトコル。複数のClaude Codeセッションが同一マシン上で並行稼働する環境で、セッション同士がメッセージを交換する仕組み。

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.2k

mcp-builder

9 files

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

anthropics-skills-13

124.2k

canvas-design

20 files

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

anthropics-skills-13

124.2k

Stats

Stars0

Forks0

Last CommitMar 11, 2026

Actions

View Source View Plugin View on GitHub View README

ccwire-protocol

CC間通信プロトコル。複数のClaude Codeセッションが同一マシン上で並行稼働する環境で、セッション同士がメッセージを交換する仕組み。

自動登録

VP（Vantage Point）経由の場合

VP の HD（Heaven's Door）が tmux セッション作成時に ccwire DB へ直接登録する。 SessionStart hook は不要。TUI 終了時に自動で unregister される。

MCP の currentSessionName 同期のため、会話の最初に一度だけ wire_register(name="セッション名") を実行する。

スタンドアロン CC の場合

環境変数でセッション名を指定し、手動で wire_register を実行する:

環境変数	必須	説明
`CCWIRE_SESSION_NAME`	Yes	セッション名
`CCWIRE_TMUX_TARGET`	No	tmux ターゲット

SessionEnd フックで自動 unregister される。

使い方

1. セッション登録（必須・最初に行う）

wire_register(name="nexus-main")

セッション名は自由に付けられる（例: "nexus-main", "issue-2", "worker-a"）
登録しないとメッセージの送受信ができない
同じ名前で再登録するとlast_seenが更新される

2. メッセージ送信

wire_send(to="issue-2", content="認証モジュールのリファクタリングをお願い", type="task_request")

メッセージタイプ:

type	用途
`task_request`	タスク依頼（デフォルト）
`response`	返答・報告
`status_update`	ステータス変更通知
`question`	質問・確認
`health_ping`	ヘルスチェック
`conflict_warning`	コンフリクト警告

3. メッセージ受信

wire_receive(limit=10)
wire_receive(from="nexus-main", type="task_request")

自分宛の未読メッセージ + ブロードキャストを取得
from: 送信元セッション名でフィルタ
type: メッセージタイプでフィルタ
direct メッセージは「delivered」に変わる
broadcast は broadcast_cursor（タイムスタンプ）で既読管理

4. 受信確認

wire_ack(message_id="msg-xxxx-xxxx")

5. ブロードキャスト

wire_broadcast(content="全セッション: mainブランチを更新しました。pullしてください。")

6. セッション一覧

wire_sessions()

7. ステータス管理

wire_status(status="busy")   # 自分のステータスを変更
wire_status()                 # 全体のステータス表示

ステータス値: idle（待機中）, busy（作業中）, done（完了）

8. セッション登録解除

wire_unregister(name="issue-2")  # 指定セッションを解除
wire_unregister()                # 自分自身を解除

省略時は自分自身を解除
SessionEnd フックで自動実行されるため、通常は手動呼び出し不要

9. スレッド取得

wire_thread(message_id="msg-xxxx-xxxx")

スレッド内のどのメッセージIDを指定しても、先頭から末尾まで時系列で返す
reply_toチェーンを自動的に辿ってLinked Listとして再構成
過去の会話コンテキストを復元するのに便利

10. セッション制御（tmux）

wire_control(session="issue-2", action="accept")
wire_control(session="issue-2", action="text", text="y")

enter: Enter キー送信
accept: y + Enter（Permission prompt の承認）
reject: n + Enter（拒否）
interrupt: Ctrl+C（中断）
text: テキスト入力 + Enter

対象セッションに tmux_target が設定されている必要がある。

MCP ツール一覧

ツール	パラメータ	説明
`wire_register`	`name`, `tmux_target?`	セッション登録
`wire_unregister`	`name?`	セッション登録解除（省略時は自分自身）
`wire_send`	`to`, `content`, `type?`, `reply_to?`	メッセージ送信
`wire_receive`	`limit?`, `from?`, `type?`	未読メッセージ取得（フィルタ可）
`wire_broadcast`	`content`	全体ブロードキャスト
`wire_sessions`	-	セッション一覧
`wire_status`	`status?`	ステータス更新/取得
`wire_ack`	`message_id`	受信確認
`wire_thread`	`message_id`	スレッド全体を取得（reply_toチェーンを辿る）
`wire_control`	`session`, `action`, `text?`	tmuxペインにキーストローク送信

メッセージフォーマット

{
  "id": "msg-<uuid>",
  "from": "nexus-main",
  "to": "issue-2",
  "type": "task_request",
  "content": "メッセージ内容",
  "timestamp": "2026-02-17T09:00:00Z",
  "reply_to": null,
  "status": "pending"
}

ワークフロー例

タスク依頼と報告

Session A (nexus-main):
  wire_send(to="issue-2", content="REQ-AUTH-001の実装をお願い", type="task_request")

Session B (issue-2):
  wire_receive() → タスクを受信
  wire_ack(message_id="msg-xxx")
  # ... 作業 ...
  wire_send(to="nexus-main", content="REQ-AUTH-001完了しました", type="response", reply_to="msg-xxx")

全体通知

Session A:
  wire_broadcast(content="mainブランチを v2.0.0 にタグ付けしました")

Session B, C, D:
  wire_receive() → ブロードキャストを受信

アーキテクチャ

VP (HD) ──── register/heartbeat/unregister ────┐
                                                ▼
CC Session A ◄──► MCP tools ◄──► ccwire MCP Server ◄──► ~/.cache/ccwire/ccwire.db (SQLite WAL)
CC Session B ◄──► MCP tools ◄──► ccwire MCP Server ◄──►        ↑
CC Session C ◄──► MCP tools ◄──► ccwire MCP Server ◄──────────┘

VP 経由: HD（Rust）が tmux セッション作成時に SQLite へ直接 register。TUI 終了時に unregister。3分間隔で heartbeat
スタンドアロン: 各 CC セッションが独自の MCP サーバープロセスを起動し、DB を通じてメッセージを交換
WAL モードにより複数プロセスからの同時アクセスに対応

自動通知（fs.watch）

各 MCP サーバーは起動時に ~/.cache/ccwire/ ディレクトリを fs.watch で監視する。他セッションが DB にメッセージを書き込むと、ファイル変更を検知して自セッション宛の未配信メッセージを自動チェックし、tmux 経由で通知する。

監視対象: ccwire.db および ccwire.db-wal（WAL モード対応）
800ms の debounce で重複チェックを抑制
wire_receive のポーリング不要で、メッセージ到着をリアルタイムに検知

tmux send-keys でCCにメッセージを送る場合

ccwire MCPツールが使えない状況（相手がまだ未登録、プラグイン未導入等）では、tmux send-keys でCCの入力欄に直接テキストを送ることができる。

必須ルール: send-keys とEnter は必ず2回に分けて送る

# 正しい例: メッセージとEnterを別々のコマンドで送る
tmux send-keys -t cw:0.0 "メッセージ内容"
tmux send-keys -t cw:0.0 Enter

# 間違い: 1つのコマンドでメッセージとEnterを同時に送る
# → 入力が確定せずメッセージが届かない場合がある
tmux send-keys -t cw:0.0 "メッセージ内容" Enter

Enterがないとメッセージは入力欄に表示されるだけで、CCには送信されない。Enterでメッセージが到達する。 また、メッセージとEnterを同一コマンドで送ると入力が確定しないケースがあるため、必ず別コマンドに分けること。

必須ルール: Enter送信の5秒後に到達確認する

Enter を送った後、相手のセッションが実際に反応して進行しているか確認する。メッセージがスタックしている（入力欄に残ったまま未送信）場合は、再度 Enter のみを送る。

# 1. メッセージ送信
tmux send-keys -t cw:0.0 "メッセージ内容"
# 2. Enter送信
tmux send-keys -t cw:0.0 Enter
# 3. 5秒待機後に到達確認（sleep 5 → tmux capture-pane で確認、または wire_receive で返信確認）

ccwire MCPが使える場合は、tmux send-keys ではなく wire_send を使うこと。構造化された通信ができ、配信保証もある。

注意事項

セッション TTL は 10 分。Heartbeat（3分間隔）で last_seen を自動更新し、heartbeat が途切れたセッションは自動削除
wire_register 時に process.pid を記録。クリーンアップ時に PID 生存を確認し、プロセスが死んだセッションを即座に削除（tmux 非依存）
SQLite WAL モードで同時アクセスを安全に処理
ブロードキャストは送信元には配信されない