voicehook

voicehook-agent

コーディングエージェントの出力を読む代わりに、話しかけましょう。

voicehook.ai は、ブラウザーで音声通話ができるサービスです。 「invite agent」をクリックして、リンクを Claude Code、Codex、または opencode に渡せば、作業を続けるエージェントと話せます。通話中の音声である Delta は、エージェントが最新の状態に保つステータスボードと FAQ に基づいて回答するため、ターミナルを開かなくても状況を把握できます。

このリポジトリにはエージェント側のコードが含まれています。voicehook-join Claude Code プラグインと、シェルを使えるあらゆるエージェントが通話に参加できる voicehook-agent CLI です。

3つの接続方法

エージェント	接続方法
Claude Code	プラグイン、2つのコマンド（下記参照）。詳細
claude.ai / Claude Desktop	カスタムコネクター https://voicehook.ai/mcp（Settings、Connectors、Add custom connector。キー不要）。ガイド
シェルを使える任意のエージェント	クイックスタート A（HTTPS ブリッジ、インストール不要）、または CLI

どれを選ぶべきでしょうか？MCP（コネクターまたはプラグイン）は入口です。インストール不要で、1回の通話につきエージェントは1つです。create_call、カード、決定を使える唯一の方法です。CLI は、1台のマシンで複数のエージェントを連携させるためのプロ向けツールです。HTTPS ブリッジはその下層のプロトコルであり、フォールバックです。

MCP／ブリッジでは、通話に参加するエージェントは1つです。アクティビティ行には、そのエージェントが手動で書き込んだ内容のみが表示されます。1台のマシン上で複数のエージェント／セッションを使い、1つの通話で作業する場合は、voicehook-agent CLI（プロ向け）を使用してください。マルチセッションリレーと Claude Code フックにより、すべてのローカルセッションのライブアクティビティログ、ステータス、決定が通話に自動で反映されます。MCP／ブリッジはサーバー上で動作するため、ユーザーのローカルセッションを確認できません。

方法	役割	使用する場面
MCP（voicehook.ai/mcp）	入口と配布	通話に参加するエージェントが1つの場合、クラウド／サンドボックスのセッション、自分で通話を開始する場合
CLI（voicehook-agent）	複数エージェント連携のためのプロ向けツール	1台のマシンで複数のエージェント／セッションを1つの通話で使う場合、すべてのセッションのライブアクティビティログが必要な場合
ブリッジ（/api/bridge/*）	下層のプロトコルとフォールバック	MCP クライアントも CLI もない場合

詳細と git を使わないインストール方法：docs/CLI.md。

Claude Code では：

/plugin marketplace add voicehook-ai/voicehook-agent
/plugin install voicehook-join@voicehook

接続したら、招待リンク（https://voicehook.ai/r/<slug>?invite=<code>）をエージェントに貼り付けると、通話に参加します。

MCP ツール（コネクターとプラグイン）：

ツール	機能
create_call	ユーザーの新しい通話を開始します（メインエージェント専用：create_call をサブエージェントに委任しないでください。リンクがそのスレッドに残ります）。human_url と share_text を返します（そのまま渡してください。通常のブラウザーでリンクを開き、アプリ内ブラウザーは使わないよう伝えます）。厳守事項：まず share_text をテキストとして表示し、接続されるまで join を再度呼び出し、その後 next のループに進みます
join	招待リンクから、チップの label を指定して通話に参加します。通話の言語で挨拶します（greet。既定でオン）。セッション、通話の言語、通話のコンテキスト（first_actions）を返します。相手が create_call のリンクを開くまでは待機し（Claude クライアントでは最大200秒、それ以外は50秒）、next_action が waiting_for_human を返します。セッションが返るまで直ちに再度呼び出し、決してターンを終了しないでください。ローカルの Claude Code では local_cli_hint も返されます（この CLI は通話中も接続を維持します）
next	次のターン（ユーザー、決定、オペレーター、コンテキスト、終了）を最大50秒待ちます。10～15秒ごとに呼び出してください。エージェントごとに1つのループを実行します。中断後には missed を返します
say	ボイスボットがテキストを読み上げます
status	ステータスボード（読み上げなし）。ボイスボットはここから回答します。チップの絵文字は任意です
show	通話ページにカード（テキスト、コード、リンク、画像）を表示します。読み上げはされません
activity	アクティビティフィードに表示する3～8語の1行。各ステップで記録します
decide	Decision Board に質問を提示します（はい／いいえ、または最大3つの選択肢）。回答は next に返されます
leave	通話から退出します

5xx、503、またはネットワークエラーが発生した場合、エージェントは2秒後に同じツールを再度呼び出すだけで済みます。セッションは有効なままです。1つの通話に複数のエージェントが参加する場合：ルール。

CLI クイックスタート

uvx voicehook-agent join 'https://voicehook.ai/r/<slug>?invite=<code>' --name <your-own-name> --model <your-model-name>

• --name と --model は必須です。エージェント自身が選ぶ表示名と、実際に実行する正確なモデルを指定します。実際のモデル名とベンダー名を指定してください。Claude でない限り、「Claude」は使わないでください。
• ?invite=<code> を含む完全な招待リンクを使用してください。
• stdout にはユーザーとボイスボットの発話が出力されます。stdin の各行はすべて音声として読み上げられます。 通話中は、ハーネスのバックグラウンドモードで voicehook-agent listen を実行し続けてください （Claude Code：run_in_background。&／nohup は使用しないでください）。対応が必要な最初のイベントで終了してあなたを起こすため、対応後に再度起動してください。0.21.4 以降、Stop フック（voicehook-agent hook install）は、あなたの join が接続中で誰も listen していない場合、ターンの終了をブロックします（listen ガード：聞こえないままターンを終わらせない（0.21.4））。0.21.5 以降、join 自体があなたの在席状態を保持し、作業中のすべてのイベントを永続的にスプールします（イベントスプール：join があなたの代わりに listen します（0.21.5））。listen はカーソルを使ってイベントを取得するため、何も失われず、Stop フックは未読イベントがあると警告します。人間の返答を待つときは、必ず decide を使い、ステータスだけを確認しないでください（0.21.6：status --waiting ... --question ... は、決定とともに「wartet auf dich」を表示します）。通話中は、まずすべての発言に返答し（say）、2 回を超えるツール呼び出しが必要な作業はバックグラウンドエージェントに任せ、ターンを短く保ってください。0.21.7 以降、新しい発言は PostToolUse フックを通じてターンの途中で届きます。

すべての決定とステータス項目には、音声ボット向けの非表示の背景情報を必ず含めてください（0.21.4）：--context "..." と、最も可能性の高い追加質問 3 つへの回答を用意したうえで、--faq "Frage::Antwort" を指定します（まだ回答がない場合は、誰が対応しているかと見込み時間を伝えます。「In Arbeit bei , Ergebnis ca. 10 Min」）。アクティビティ行にも含められます。status では、これらの情報は直前の項目に紐付きます。含めない場合、CLI がヒントを表示します（docs/CLI.md を参照）。

ポーリングを使わないループ（say、next、status、leave）、ステータスボード、アクティビティフック、すべてのフラグについては、docs/CLI.md を参照してください。0.21.0 以降：decide --context "..." は、質問の背景情報を Delta に伝えます。ui large decisions ／ ui layout thirds ／ ui focus voicehook は、人間側の通話ページを操作します。status|activity --project NAME は、あなたのプロジェクトをタグ付けします（ページ操作：UI（0.21.0））。

0.23.0 以降、通話中のエージェントは Delta に恒常的なルールや事実を伝えられるため、Delta がより多くの質問に自分で答えられるようになります：voicehook-agent delta-rule add "Sprich den Kunden mit Sie an"、voicehook-agent delta-note add "Der Release ist am Freitag"、... list、... rm <id>。以降のターンから通知なしで適用され、ルールは最大 20 件、300 文字の事実は最大 30 件です。

join の直後（0.21.4）、CLI はこのマシンで実行中のほかの Claude Code ／ Codex セッションを一覧表示し、人間に「Soll ich die anderen N Sessions hier einbinden, damit sie ihren Status in den Call bringen?」と尋ねることを提案します。了承された場合、エージェントは表示されたセットアップコマンドを実行します。MCP またはブリッジ上のエージェントはローカルセッションを確認できません。CLI をインストールすれば原則として利用できると伝えます：uv tool install voicehook-agent && voicehook-agent hook install。

1 台のマシンで複数の Claude Code セッションを使う場合（0.15.0）：voicehook-agent hook install を 1 回実行してください。1 つのセッションが通話中に、ほかのすべてのセッションが、それぞれのセッション名でターンの目標、PR、デプロイ、エラーを通話のアクティビティフィードに報告します （複数セッションのリレー：同じマシン上のすべての Claude Code セッションが通話に参加（0.15.0））。0.16.0 以降、このようなヘルパーセッションは人間に質問することもでき（decide、relay-next または decide --wait で回答）、独自のステータスボードも保持できます（status --doing ...） （ヘルパーセッション：決定ボードと独自のステータスボード（0.16.0））。

OpenAI Codex CLI（0.20.0）：voicehook-agent hook install --agent codex を実行すると、同じ自動化設定が ~/.codex に書き込まれます（hooks.json、notify、status、decide、next、activity を備えたローカル MCP サーバー。先にバックアップしてください）。その後、Codex で /hooks を使ってフックを一度信頼してください（その他のコーディングエージェント（0.20.0））。

料金

毎日約 10 分間は無料です。10 EUR からのプリペイド制で、サブスクリプションはありません。

ドキュメント

ドキュメント	内容
docs/CLI.md	インストール、エージェントループのコマンド、ステータスボードと FAQ、話し方、アクティビティフィードとフック、シェイプ、セルフアップデート、Claude Code プラグイン、スキル登録
docs/PROTOCOL.md	標準入力／標準出力プロトコル、データチャネルのトピック、リレーのフラグ、HTTPS ブリッジ、ウェイクマーカー、サーバーの動作、環境変数
docs/DEVELOPMENT.md	CI ジョブ、プラグインのリリース、CLI のリリース、PyPI のセットアップ
OPERATOR-PROTOCOL.md	サーバー側オペレータープロトコル（voicehook.ai）

開発、CI、リリース

CI では、すべての PR でテスト、ruff、プラグインの検証、シークレットスキャン、スキルのドリフトチェックを実行します。 リリースタグ、プラグインのリリースチェックリスト、PyPI のセットアップについては、 docs/DEVELOPMENT.md をご覧ください。

ライセンス

MIT です。LICENSE をご覧ください。

---

ドイツで開発され、ニュルンベルク（Hetzner）でホストされています。Cookie もトラッキングも通話録音もありません。 あなたやエージェントの発言が保存されることはありません。プライバシーポリシー