ACP サポート

ACP 互換エディターで Matrix を使用します。

Matrix は Agent Client Protocol または (ACP) をサポートしているため、互換性のあるエディターや IDE で直接使用できます。

ACP は、コードエディターと AI コーディングエージェント間の通信を標準化するオープンプロトコルです。

設定

ACP 経由で Matrix を使用するには、matrix acp コマンドを実行するようにエディタを設定します。

このコマンドは、stdio 経由で JSON-RPC 経由でエディターと通信する ACP 互換のサブプロセスとして Matrix を開始します。

以下は、ACP をサポートする一般的なエディタの例です。

Zed

Zed 構成 (~/.config/zed/settings.json) に追加します。

{
  "agent_servers": {
    "Matrix": {
      "command": "matrix",
      "args": ["acp"]
    }
  }
}

これを開くには、コマンドパレットの agent: new thread アクションを使用します。

keymap.json を編集してキーボードショートカットをバインドすることもできます。

[
  {
    "bindings": {
      "cmd-alt-o": [
        "agent::NewExternalAgentThread",
        {
          "agent": {
            "custom": {
              "name": "Matrix",
              "command": {
                "command": "matrix",
                "args": ["acp"]
              }
            }
          }
        }
      ]
    }
  }
]

JetBrains IDE

documentation に従って、JetBrains IDE acp.json に追加します：

{
  "agent_servers": {
    "Matrix": {
      "command": "/absolute/path/bin/matrix",
      "args": ["acp"]
    }
  }
}

これを開くには、AI Chat エージェントセレクターで新しい「Matrix」エージェントを使用します。

Avante.nvim

Avante.nvim 設定に追加:

{
  acp_providers = {
    ["matrix"] = {
      command = "matrix",
      args = { "acp" }
    }
  }
}

環境変数を渡す必要がある場合:

{
  acp_providers = {
    ["matrix"] = {
      command = "matrix",
      args = { "acp" },
      env = {
        MATRIX_API_KEY = os.getenv("MATRIX_API_KEY")
      }
    }
  }
}

CodeCompanion.nvim

CodeCompanion.nvim で Matrix を ACP エージェントとして使用するには、以下を Neovim 構成に追加します。

require("codecompanion").setup({
  interactions = {
    chat = {
      adapter = {
        name = "matrix",
        model = "claude-sonnet-4",
      },
    },
  },
})

この構成は、Matrix をチャットの ACP エージェントとして使用するように CodeCompanion をセットアップします。

環境変数 (MATRIX_API_KEY など) を渡す必要がある場合、詳細については、CodeCompanion.nvim ドキュメントの「アダプターの構成: 環境変数」を参照してください。

サポート

Matrix は、ACP 経由でもターミナル内で動作するのと同じように動作します。すべての機能がサポートされています。

組み込みツール (ファイル操作、ターミナルコマンドなど)
カスタムツールとスラッシュコマンド
Matrix 設定で構成された MCP サーバー
AGENTS.md のプロジェクト固有のルール
カスタムフォーマッタとリンター
エージェントと権限システム