Roo Logger

Roo Activity Loggerは、Roo Code（Cline）のアクティビティ（コマンド実行、コード生成など）を自動的に記録し、ログをJSONファイルとして保存して後の検索や分析を容易にするMCPサーバーです。

開発者ツール知識管理と記憶 #アクティビティログ #自動記録 #JSON保存 #開発ツールローカル .TypeScript

スコア : 2.5ポイント

ダウンロード数 : 8.1K

更新時間 : 2025-04-28

サイトを開く

Rooアクティビティロガーとは？

Rooアクティビティロガーは、Rooの開発活動（コマンド実行、コード生成、ファイル操作など）を自動的に記録するMCPサーバーです。すべてのログはJSON形式で保存され、後の検索や分析が容易です。

Rooアクティビティロガーの使い方は？

ClineまたはRoo - Codeの設定にこのサーバーを追加することで、自動的なアクティビティ記録を有効にします。記録されたログは、タスクの復旧やコンテキストの再構築に利用できます。

適用シナリオ

開発過程の記録、タスクの進捗追跡、中断した作業の復旧が必要な開発者に適しています。

主要機能

複数のアクティビティタイプの記録

コマンド実行、コード生成、ファイル操作、エラー記録など、複数のアクティビティタイプのログ記録をサポートします。

詳細なログ情報

各ログには、一意のID、タイムスタンプ、アクティビティタイプ、概要、詳細、意図、コンテキストなどの情報が含まれています。

柔軟なログ保存

ログ保存ディレクトリをカスタマイズでき、日付ごとにログファイルを整理します。

利点

開発活動を自動的に記録するため、手動での記録作業を削減します。

ログ形式が統一されているため、検索や分析が容易です。

複数のアクティビティタイプをサポートし、開発の全プロセスを網羅します。

柔軟なログ保存オプションで、さまざまなニーズに対応します。

制限

ClineまたはRoo - Codeで設定する必要があり、有効にするには設定が必要です。

大規模なプロジェクトでは多くのログファイルが生成される可能性があり、定期的なクリーンアップが必要です。

使い方

Rooアクティビティロガーのインストール

npxで直接実行するか、ローカルでリポジトリをクローンして設定します。

ClineまたはRoo - Codeの設定

設定ファイルにRooアクティビティロガーのMCPサーバー設定を追加します。

アクティビティの記録開始

毎回の操作でlog_activityツールを呼び出し、アクティビティタイプ、概要、意図、コンテキストを記録します。

使用例

コマンド実行の記録

npmコマンドの実行過程を記録します。

過去のログの検索

日付範囲とタイプで過去のログを絞り込みます。

よくある質問

Rooアクティビティロガーをローカルにインストールする方法は？

ログファイルはどこに保存されますか？

中断したタスクをどのように復旧するか？

🚀 Roo 活動ログ

Roo Activityは、活動ログを管理するためのツールです。保存されたログファイルの一覧表示、ログの検索、ログファイルリストの取得という3つの主要な機能モジュールを提供します。

🚀 クイックスタート

Roo Activityを使用することで、活動ログの管理が簡単になります。以下の機能モジュールを利用して、ログを効率的に操作できます。

✨ 主な機能

ログファイルリスト

get_log_files コマンドを使用すると、保存されたログファイルの一覧を表示できます。最大検索深度を指定することもできます。

例

# 基本的な使用例
get_log_files --logsDir "/absolute/path/to/logs"

# 詳細な使用例
get_log_files \
--logsDir "/absolute/path/to/logs" \
--limit 5 \
--offset 2 \
--logFilePrefix "roo-activity-" \
--logFileExtension ".json" \
--maxDepth 3

パラメータの説明

名称	必須かどうか	タイプ	説明
`logsDir`	はい	文字列	ログディレクトリ（絶対パス）
`limit`	いいえ	数字	最大ファイル数。デフォルトは10です。
`offset`	いいえ	数字	スキップするファイル数。デフォルトは0です。
`logFilePrefix`	いいえ	文字列	ログファイルの接頭辞。デフォルトは `"roo-activity-"` です。
`logFileExtension`	いいえ	文字列	ログファイルの拡張子。デフォルトは `".json"` です。
`maxDepth`	いいえ	数字	最大検索深度。デフォルトは3です。

ログの検索

search_logs コマンドを使用すると、複数のフィルターを使って保存されたログを検索できます。

例

# 基本的な使用例
search_logs --logsDir "/absolute/path/to/logs"

# フィルターの使用例：タイプでフィルタリング
search_logs \
--logsDir "/absolute/path/to/logs" \
--type "command_execution"

パラメータの説明

名称	必須かどうか	タイプ	説明
`logsDir`	はい	文字列	ログディレクトリ（絶対パス）
`logFilePrefix`	いいえ	文字列	ログファイルの接頭辞。デフォルトは `"roo-activity-"` です。
`logFileExtension`	いいえ	文字列	ログファイルの拡張子。デフォルトは `".json"` です。
`type`	いいえ	文字列	活動タイプをフィルタリング（command_execution, code_generation, file_operation, error_encountered, decision_made, conversation）
`level`	いいえ	文字列	ログレベルをフィルタリング（debug, info, warn, error）
`startDate`	いいえ	文字列	開始日（形式：YYYY-MM-DD）
`endDate`	いいえ	文字列	終了日（形式：YYYY-MM-DD）
`searchText`	いいえ	文字列	要約または詳細情報内でテキストを検索
`limit`	いいえ	数字	最大返却ログ数。デフォルトは50です。
`offset`	いいえ	数字	スキップするログ数。デフォルトは0です。
`logPath`	いいえ	文字列配列	検索対象の特定のログファイルパスを含む

🔧 パラメータの説明

ログの記録

ログを記録する際に使用できるパラメータは以下の通りです。

基本情報

名称	必須かどうか	タイプ	説明
`level`	はい	文字列	ログレベル（debug, info, warn, error）
`message`	はい	文字列	ログメッセージ

追加情報

名称	必須かどうか	タイプ	説明
`timestamp`	いいえ	文字列	タイムスタンプ
`context`	いいえ	辞書	コンテキスト情報
`activity_id`	いいえ	文字列	活動ID

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。具体的な内容は以下の通りです。

MIT License

Copyright (c) [Year] [Author Name]
Author: [Your Name] <[Your Email]>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.