Brummer

🚀 🐝 ブラマー

インテリジェントなモニタリング機能を備えたターミナルUI開発パートナー

Brummerは、npm/yarn/pnpm/bunスクリプトを管理するためのTUI（ターミナルユーザーインターフェイス）であり、外部ツールからアクセス可能なMCPサーバーを統合しています。インテリジェントなログ管理、リアルタイムモニタリング、および開発ツールとのシームレスな統合を提供します。

🚀 クイックスタート

Brummerの詳細なドキュメントはこちらで確認できます。以下はクイックリンクです。

• 入門ガイド
• インストールオプション
• MCP統合

✨ 主な機能

• 複数のパッケージマネージャーサポート：npm、yarn、pnpm、またはbunを自動的に検出して使用します。
• モノレポサポート：pnpmワークスペース、npmワークスペース、yarnワークスペース、Lerna、Nx、およびRushを完全にサポートします。
• 多言語検出：Node.js、Go、Rust、Java（Gradle/Maven）、.NET、Python、Ruby、PHP、Flutterなどのコマンドを自動検出します。
• インタラクティブなTUI：スクリプトをナビゲートし、プロセスをモニタリングし、ログをリアルタイムで表示します。
• スマートログ管理：
  • 自動エラー検出と優先順位付け
  • ログフィルタリングと検索機能
  • ビルドイベントとテスト結果の検出
• MCPサーバー統合：外部ツール（VSCode、Claude Codeなど）が以下のことを行えます。
  • ログ出力とエラーにアクセスする
  • コマンドを非同期で実行する
  • プロセスの状態をモニタリングする
• プロセス管理：複数のプロセスを同時に開始、停止、およびモニタリングします。
• VS Codeタスク：.vscode/tasks.jsonからVS Codeタスクを検出して実行します。

📦 インストール

クイックインストール（ワンライナー）

curl -sSL https://raw.githubusercontent.com/standardbeagle/brummer/main/quick-install.sh | bash

wget -qO- https://raw.githubusercontent.com/standardbeagle/brummer/main/quick-install.sh | bash

irm https://raw.githubusercontent.com/standardbeagle/brummer/main/quick-install.ps1 | iex

パッケージマネージャー

# npxで直接実行（インストール不要）
npx @standardbeagle/brum

# グローバルにインストール
npm install -g @standardbeagle/brum

# またはyarnを使用する場合
yarn global add @standardbeagle/brum

# またはpnpmを使用する場合
pnpm add -g @standardbeagle/brum

go install github.com/standardbeagle/brummer/cmd/brum@latest

ソースからインストール

# リポジトリをクローン
git clone https://github.com/standardbeagle/brummer
cd brummer

# Makeを使用する（推奨）
make install-user    # 現在のユーザー向けにインストール (~/.local/bin)
# または
make install        # システム全体にインストール（sudoが必要）

# インタラクティブインストーラーを使用する
./install.sh

# 手動でビルド
go build -o brum ./cmd/brum
mv brum ~/.local/bin/  # PATHに追加

💻 使用例

基本的な使用法

package.jsonファイルがあるディレクトリで：

brum

オプション

brum [flags]

Flags:
  -d, --dir string   package.jsonを含む作業ディレクトリ (デフォルト ".")
  -p, --port int     MCPサーバーのポート (デフォルト 7777)
      --no-mcp       MCPサーバーを無効にする
      --settings     現在の設定をソースとともに表示する
  -h, --help         brumのヘルプを表示する

TUIナビゲーション

• Tab：ビュー（スクリプト、プロセス、ログ、エラー、URL、設定）を切り替えます。
• ↑/↓ または j/k：項目をナビゲートします。
• Enter：選択/実行します。
• n：実行コマンドダイアログを開きます（スクリプトタブから）。
• Esc または q：戻ります。
• /：ログを検索します。
• p：高優先度のログを切り替えます。

プロセス管理

• ナビゲート：↑/↓矢印を使用してプロセスを選択します（色付きのインジケーターで状態を表示）。
• s：選択したプロセスを停止します（実行中のプロセスのみ有効 🟢）。
• r：選択したプロセスを再起動します（停止してから同じスクリプトを開始）。
• Ctrl+R：すべての実行中のプロセスを再起動します。
• Enter：選択したプロセスのログを表示します。

プロセスの状態インジケーター:

• 🟢 実行中 - プロセスがアクティブです（停止/再起動可能）。
• 🔴 停止 - プロセスが手動で停止されました。
• ❌ 失敗 - プロセスがエラーで終了しました。
• ✅ 成功 - プロセスが正常に完了しました。
• ⏸️ 待機中 - プロセスが起動中です。

自動クリーンアップ:

• Brummerが終了すると、すべての実行中のプロセスが自動的に停止します。
• Ctrl+Cまたは'q'を使用して、きれいにクリーンアップしながら終了します。
• ヘッダーに表示されるプロセス数：「実行中のプロセス (2)」。

ログ管理

• c：最新のエラーをクリップボードにコピーします。
• f：フィルターを表示/管理します。

その他

• ?：ヘルプを表示します。
• Ctrl+C：終了します。

📚 ドキュメント

Brummerは、.brum.tomlファイルを通じた階層的な構成をサポートしています。構成は以下の順序で読み込まれ（後の値が前の値を上書きします）：

1. ~/.brum.toml（グローバルユーザー設定）
2. プロジェクトルートと親ディレクトリ（ルートまで上る）
3. 現在の作業ディレクトリの.brum.toml

現在の構成を表示する

# ソースファイルとともに現在の設定を表示する
brum --settings

# 現在の設定から構成ファイルを作成する
brum --settings > .brum.example.toml

構成オプション

プロジェクトまたはホームディレクトリに.brum.tomlファイルを作成します：

# パッケージマネージャーの優先順位
preferred_package_manager = "pnpm"  # npm, yarn, pnpm, bun

# MCPサーバーの設定
mcp_port = 7777
no_mcp = false

# プロキシ設定
proxy_port = 19888
proxy_mode = "reverse"  # "reverse" または "full"
proxy_url = "http://localhost:3000"  # オプション: このURLを自動プロキシする
standard_proxy = false
no_proxy = false

設定タブ

設定タブでは以下のことができます：

• パッケージマネージャーの選択：npm、yarn、pnpm、またはbunから選択します。
• MCPサーバーのインストール：開発ツールのワンクリックインストール：
  • Claude Desktop ✓
  • Claude Code ✓
  • Cursor ✓
  • VSCode (MCP拡張機能付き) ✓
  • Cline ✓
  • Windsurf ✓
  • Roo Code (実験的)
  • Augment (実験的)
  • Cody (実験的)

🔧 技術詳細

MCPハブモード 🆕

Brummerのハブモードを使用すると、MCPクライアントが単一の接続を介して複数のBrummerインスタンスを検出し、制御することができます。

クイックセットアップ

1. MCPクライアントを一度設定する：

   {
     "servers": {
       "brummer-hub": {
         "command": "brum",
         "args": ["--mcp"]
       }
     }
   }
   

2. 各プロジェクトでBrummerを実行する：

   cd ~/projects/frontend && brum
   cd ~/projects/backend && brum
   

3. MCPクライアントでハブツールを使用する：

   • instances/list - すべての実行中のインスタンスを表示する
   • instances/connect - 特定のインスタンスに接続する
   • すべてのインスタンスツールが接頭辞付きで利用可能になる

📚 ハブモードの完全なドキュメント

MCPサーバー統合

MCPサーバーはデフォルトでポート7777で実行され、公式のMCP Streamable HTTPトランスポートプロトコルを実装しています。

トランスポートプロトコル

単一のエンドポイント：http://localhost:7777/mcp

接続タイプ：

1. 標準JSON-RPC（Accept: application/jsonを指定したPOST）
2. Server-Sent Events（Accept: text/event-streamを指定したGET）
3. SSEレスポンス（Accept: text/event-streamを指定したPOST）

接続例

// SSEストリーミング接続
const eventSource = new EventSource('http://localhost:7777/mcp');
eventSource.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  console.log('Received:', msg);
};

// JSON-RPCリクエストを送信する
fetch('http://localhost:7777/mcp', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json'
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/list'
  })
});

利用可能なツール

スクリプト管理：scripts_list, scripts_run, scripts_stop, scripts_status ログ管理：logs_stream, logs_search ブラウザツール：browser_open, browser_screenshot, browser_navigate, repl_execute プロキシツール：proxy_requests テレメトリ：telemetry_sessions, telemetry_events

開発

プロジェクト構造

brummer/
├── cmd/brum/            # メインアプリケーションのエントリーポイント
├── internal/
│   ├── tui/             # ターミナルUIコンポーネント
│   ├── process/         # プロセス管理
│   ├── mcp/             # MCPサーバーの実装
│   ├── logs/            # ログの保存と検出
│   └── parser/          # package.jsonの解析
├── pkg/
│   ├── events/          # イベントシステム
│   └── filters/         # ログフィルタリング
└── go.mod

ビルド

go build -o brum ./cmd/brum

テスト

go test ./...

📄 ライセンス

MITライセンスの下で公開されています。