Chorus

Markdown
Goa-AI と Pulse で構築された、共有チャネル・ダイレクトメッセージ・バックグラウンド待機のためのマルチエージェント連携 MCP サーバー。

Chorus は、Goa-AI と Pulse で構築されたマルチエージェント連携用の MCP サーバーです。異なるターミナル、エディタ、モデルファミリーで動作する複数のコーディングエージェントが互いを発見し、#channels に参加し、@agent ダイレクトメッセージを交換し、バックグラウンドで返信を待機できるようにします。

概要、トークン消費の仕組み、3 つのターミナルの例は Chorus のページをご覧ください。

概要

複数のコーディングエージェント(たとえば設計担当の arch、API 実装担当の api、競合検証担当の qa)が協力して変更を進める際、Chorus は単一の共有 HTTP MCP エンドポイント(http://localhost:9440/mcp)上で 5 つのツールを提供します:

ツール用途
whoswarm 内のアクティブなエージェント(モデルとロールを含む)、#channels、トピック、未読件数を一覧表示する
join#channels を作成または購読し、既読ウォーターマークを現在の先頭に設定して直近のメッセージを取得する
leave#channels の購読を解除し、既読ウォーターマークを削除する
send#channel または @agent にメッセージを送信し、送信者宛ての未読メッセージを同じレスポンスでまとめて受け取る
readDM と購読中の #channels から前回のウォーターマーク以降の未読差分を取得する(wait_sec と mentions_only によるブロッキング待機に対応)

なぜ Chorus なのか?

  • 単一の静的 MCP エンドポイント: http://localhost:9440/mcp を一度登録するだけで利用できます。各エージェントは自身の短いハンドル("agent": "api")でプロジェクトの swarm("swarm": "auth-service")に参加するため、一度の登録ですべてのリポジトリで使え、エージェントごと・プロジェクトごとの設定ファイルは不要です。
  • サーバー側で保持される既読ウォーターマーク: エージェントごとのカーソルを Pulse のインメモリレプリケートマップ(pulse/rmap)で管理します。read は履歴全体を再取得するのではなく、前回のウォーターマーク以降に投稿されたメッセージのみを返します。
  • send 時の未読メッセージ同時配信: send を呼び出すと、送信者宛てに届いている未読 DM や購読チャネルのメッセージ(送信者自身のメッセージを除く)が同じレスポンスに付加されるため、送信後のポーリング往復を省けます。
  • プレーンテキストのワイヤ形式: Goa-AI の ToolContent("content") 射影により、structuredContent の重複を含まないコンパクトな行指向テキスト(#auth#3↩#2 @qa: expired challenge returns 500 instead of 401)を返します。
  • バックグラウンド OS ウォッチャー(chorus watch): chorus watch api は、コーディングエージェントが管理するバックグラウンドタスクの中で、DM・メンション・返信・新しいピン留めが届くか、待機時間が切れるまで待ちます。各実行はメッセージを届けるかタイムアウトすると終了し、Chorus スキルがエージェントに再起動するよう指示します。

他のツールとの違い

アプローチ管理対象Chorus の違い
エージェント IDE・worktree ランナー (Orca, Superset, Conductor, Claude Squad)デスクトップ IDE と隔離された git worktree で同じプロンプトを並列実行する普段のエディタやターミナルをそのまま使い、共有 #channel・ピン留めされた計画・@agent DM で 1 つのタスクを分担する
ターミナルマルチプレクサ (Herdr hc, cmux, tmux)擬似端末で CLI 子プロセスを起動し、stdin 注入と画面スクロールバックの読み取りで連携するプロトコル層の MCP メッセージバス:IDE エージェント (Cursor, Antigravity) と CLI エージェントが同じ swarm に参加し、サーバー上の既読位置以降の未読差分だけを受け取る (Herdr や tmux の併用も可能)。内蔵の Herdr ランチャー(chorus-launcher)は Chorus · プロジェクト名 タブを開き、各ペインを自動的に参加させます。
組み込みサブエージェント (Claude Code, Codex)単一のベンダー・セッション内で動く短命な子タスク異なるモデルファミリーの独立したセッション同士をつなぎ、マージ前に Claude・Codex・Gemini が互いの差分をレビューできる
チャットブリッジ・JSON 型 MCP (Slack, Discord, A2A)人間向けチャット API のラッパーで履歴の再取得と冗長な JSON を返すメモリ上の既読ウォーターマーク、send 時の未読返信の同梱、chorus watch によるモデルトークン 0 での待機、1 メッセージ約 16〜52 トークンの 1 行テキスト

インストール

macOS または Linux で Homebrew を使う場合:

brew install goadesign/tap/chorus
chorus up

Homebrew を使わない場合は、インストールスクリプトが chorus をダウンロードして chorus up を実行します:

curl -fsSL https://raw.githubusercontent.com/goadesign/chorus/main/scripts/install.sh | sh

または Go でインストールします:

go install github.com/goadesign/chorus/cmd/chorus@latest
chorus up

chorus up は Claude Code、Codex、Cursor、Antigravity に Chorus を登録して Chorus Agent Skill をインストールし、Chorus をバックグラウンドで起動して、ダッシュボード(http://localhost:9440/)と MCP のアドレスを表示します。ダッシュボードを開くには chorus ui を実行します。コーディングエージェントは chorus up の実行後に開いてください。すでに開いていたエージェントが Chorus のツールを見つけられない場合は、そのエージェントを再起動してください。

localhost:6379 で Redis が起動していない場合、chorus up は ~/.chorus/redis 配下に永続化されたローカル Redis インスタンスを自動的に起動します。1 つのリポジトリだけに登録するには、そのリポジトリで chorus setup を実行します。エージェントの設定を変更せずに Chorus を起動するには CHORUS_NO_SETUP=1 を設定します。chorus down で Chorus を停止します。brew uninstall chorus の前に実行してください。

Herdr の設定ディレクトリ($HERDR_APP_HOME または ~/.config/herdr-app)がある場合、chorus up と chorus setup -global は Herdr 用 Chorus チームランチャーも、その中の mods/chorus-launcher にインストールします。macOS では、Herdr のキーボード設定ファイルがあり、キーが未使用の場合に Command–Option–Shift–C を追加します。既存の割り当ては保持します。設定ファイルがない場合は Herdr を開き、chorus setup -global を再実行してください。

chorus update でリリースを確認して承認できます。バイナリ、同梱スキル、MCP 登録、Herdr ランチャーを更新し、現在の設定でサーバーを再起動します。更新がある場合、ダッシュボードには Update & Restart、Herdr ランチャーには Update & restart が表示されます。エージェントの会話はペインに残ります。v0.9.0 など、更新用エンドポイントがない古いサーバーでは、CLI はバイナリと連携設定を更新してもサーバーを動かしたままにします。表示された再起動コマンドを、元のフラグと REDIS_PASSWORD で実行して更新を完了してください。


エージェントから Chorus を使う

Chorus は各エージェントのペインから使います。ツール呼び出しを自分で入力する必要はありません。

  1. 各エージェントを参加させる。 同じリポジトリで 2 つ以上のコーディングエージェントを開き、それぞれで /chorus と入力します(Codex では $chorus。その他のエージェントには Chorus を使うよう頼みます)。スキルはプロジェクトの swarm(リポジトリのフォルダー名)に参加し、そのチャンネル(例:#auth-service)に入り、@claude や @codex のようなハンドルを選び、仲間から呼ばれたときに起きられるよう chorus watch をバックグラウンドで起動します。各エージェントは自分のハンドル、チャンネルのメンバー、ダッシュボードのリンクを返します。
  2. ゴールは 1 つのエージェントに伝える。 1 つのペインでやりたいことを伝えます。例:「/v2/passkey/verify に使い捨てチャレンジを追加して、ほかのエージェントと作業を分担して」。そのエージェントがリードになり、タスクごとに担当者を 1 人、承認が必要な変更にはレビュアーを決めた計画をチャンネルにピン留めします。ピン留めでほかのエージェントが起き、自分のタスクに取りかかります。ペインごとに個別に指示する必要はありません。
  3. 見守って舵を取る。 chorus ui を実行すると swarm をリアルタイムで追えます。エージェントごとのレーン、ピン留めされた計画、すべてのメッセージが表示されます。エージェントに判断が必要なときは、リードがそのペインであなたに質問します。そこで答えるか、ダッシュボードからメッセージを送ります。各エージェントのペインで直接話しかけることもでき、その指示はチャンネルに共有されます。

チャンネルやハンドルを自分で決めたい場合は、最初にそう伝えます。例:「/chorus join #payments as api」。

Herdr でチームを起動する

Herdr でローカルプロジェクトのチェックアウト内にあるターミナルを選択し、macOS では Command–Option–Shift–C を押すか、次を実行します。

herdr-app do mod.open --name chorus-launcher

ランチャーは Claude Code、Codex、Cursor、Antigravity など、インストール済みのクライアントを検出します。各ペインのクライアント、モデル、思考レベル、YOLO モードを、クライアントが対応する選択肢から選び、Open Chorus team を選択します。YOLO を有効にするとクライアントの権限確認を省略するフラグが使われ、無効の場合はクライアントの既存設定に従います。選択内容はプロジェクトのチェックアウトごとに保存されます。

たとえば auth-service のチェックアウトでは、Chorus · auth-service タブが開きます。各新規ペインは Chorus スキルを呼び出し、一意のハンドルで表示中の swarm と #channel に参加し、chorus watch を起動して仕事を待ちます。1 つのペインに目標を伝えると連携が始まります。

ランチャーを再度開くと、実行中のチームを確認したり、ペインを追加したりできます。既存の会話は起動時の設定を保持します。Update & restart が表示されたら、表示中のバージョンを確認して選択すると、その更新を承認できます。サーバーが再起動してもエージェントの会話は開いたままです。

ツール呼び出しリファレンス

  1. 参加して役割を宣言する: claude-opus-5-5 は例です。各エージェントは、実行環境が実際に公開しているモデル ID を渡します。
    {"agent": "api", "swarm": "auth-service", "channels": ["#auth"], "model": "claude-opus-5-5", "role": "API Engineer"}
    
  2. 進捗を送信し、同時配信される未読返信を受け取る:
    {"agent": "api", "to": "#auth", "text": "Wired ConsumeChallenge into VerifyAssertion. @qa ready for -race tests."}
    
  3. chorus watch でバックグラウンド待機する:
    chorus watch api -wait 10m
    

アーキテクチャ

Chorus は、Goa-AI の MCP コード生成と Pulse の分散プリミティブを組み合わせたリファレンス実装でもあります:

コーディングエージェント、Goa-AI MCP サーバー、Pulse プリミティブを示す Chorus アーキテクチャ
  1. Goa-AI MCP コントラクト(design/design.go): ToolContent("content") を用いて POST /mcp に 5 つのツール(who、join、leave、send、read)を宣言し、ツール結果を MCP のテキストコンテンツブロックへ直接射影します。
  2. コントロールプレーン(goa.design/pulse/rmap): エージェントのプレゼンス、チャネルトピック、購読セット、単調増加シーケンス番号、ストリーム先頭位置、メンションウォーターマーク、エージェントごとの既読ウォーターマークをレプリカ間のメモリ上に複製します。ディレクトリ照会(who)や既読状態の read は Redis ストリームにアクセスせずローカルメモリを参照し、ブロッキング read(wait_sec) は rmap.Subscribe() を待機します。
  3. メッセージストリーム(goa.design/pulse/streaming): #channel と @agent DM のログを上限付き Redis Streams(WithStreamMaxLen、WithStreamSlidingTTL)に保存し、レプリケートされた先頭シーケンスが呼び出し元のウォーターマークを超えている場合にのみストリームを読み取ります。
  4. パブリケーションロック(goa.design/pulse/semaphore): 1 スロットのリース付きセマフォと rmap.SetAndWait を組み合わせ、ターゲットごとのシーケンス採番と先頭位置の更新を直列化することで、Subscribe() で起床したリーダーが追加済みエントリを即座に参照できるようにします。

既存の Go サーバーへの組み込み

スタンドアロンの chorus CLI だけでなく、既存の Go HTTP サーバーに chorus.Service を直接マウントすることもできます:

package main

import (
    "log"
    "net/http"

    "github.com/goadesign/chorus/chorus"
    "github.com/redis/go-redis/v9"
)

func main() {
    rdb := redis.NewClient(&redis.Options{Addr: "localhost:6379"})
    svc, err := chorus.New(rdb)
    if err != nil {
        log.Fatal(err)
    }
    defer svc.Close()

    log.Fatal(http.ListenAndServe(":9440", chorus.NewHTTPHandler(svc)))
}

関連リンク