ドキュメント

Q: 新しいエントリが表示されない

エージェントがLogTrace経由で接続されていないか、接続前にセッションを開始しています。 エージェントを再接続し、新しいセッションを開始してから、簡単なコマンドを実行して記録されるか確認してください。

Q: AI分析が表示されない

AI分析はライセンス認証とプロバイダーキー設定後に利用できます。 ライセンスを認証してから、AI分析設定でプロバイダーキーとモデルを追加してください。

Q: AI分析が失敗する

APIキー、モデル名、またはプロバイダー側のアクセス権が正しくない可能性があります。 選択したプロバイダーを確認し、モデルが利用可能であることを確かめ、必要に応じてキーを更新してください。

概要

LogTraceでできること

このデスクトップアプリは、AIコーディングエージェントの操作をローカルに記録し、セッション後に何が起きたかを見返せるようにします。シェルコマンド、ファイルの読み取り、メモ、出力、時刻、プロジェクト情報、危険度を操作履歴としてローカルに保存します。

現在サポートされているプラットフォームはWindowsです。その他のデスクトップOSへの対応は今後予定しています。

Claude Code、Codex、Cursorなど、ローカルHTTP MCPサーバーを追加できるAIツールや、その他のMCP対応クライアントで利用できます。

ログは、エクスポートまたは共有しない限り、自分のパソコン上に保存されます。このレビュー機能は、ワークフローをオンラインダッシュボードへ送らずに、エージェントの操作を確認したい開発者向けです。

インストール

Windowsにインストール

AIコーディングエージェントを使っているWindowsパソコンにLogTraceをインストールします。ダウンロードページからは、常に最新のWindowsインストーラーを入手できます。その他のデスクトップOSはまだ利用できませんが、今後対応予定です。

Windows版 v0.9.0 をダウンロード

エージェントの接続

AIコーディングエージェントを接続

エージェントを接続する前に、LogTraceを起動してください。このアプリはClaude Code、Codex、CursorなどのMCP対応クライアント向けに、Streamable HTTP MCPサーバーとして機能します。LogTraceの設定でMCPサーバーのポートを変更した場合は、 43117 を設定したポートに置き換えてください。

自動セットアップ

LogTraceアプリの接続設定では、CodexとClaude Code向けに自動セットアップを利用できます。手動で設定をコピーする代わりに、対象エージェントのタブで自動セットアップを実行してください。

Codex: 全体の Codex 設定ファイルと AGENTS.md に、LogTrace MCP URLとログ記録ルールを追加または更新します。
Claude Code: Claude CodeにLogTraceをuser scopeのMCPサーバーとして追加し、全体の CLAUDE.md と関連するClaude hooksを更新します。

Manual setup

自動セットアップを使わない場合は、利用するMCPクライアントに以下の接続情報を設定してください。

MCP URL

http://127.0.0.1:43117/mcp

サーバー名: LogTrace
通信方式: Streamable HTTP
ポート: 43117

ログ記録ルール

以下の例のような指示を、エージェントが使用するファイルに追加します。たとえばCodexなら AGENTS.md 、Claude Codeなら CLAUDE.md です。そのまま貼り付けても、自分のプロジェクト指示に合わせて書き換えても構いません。ツール承認の挙動は各エージェント側で制御されます。

プロジェクト指示

## LogTrace ログ記録ルール

- 必要に応じて LogTrace MCP ツールを作業ログの一部として使う
- `agent_name` には常に "エージェント名" を使う
- シェルコマンドを実行した後は `log_shell_execute` を呼ぶ
- 重要なファイルを読んだ後は `log_read_file` を呼ぶ
- 調査メモや判断理由には `log_note` を呼ぶ
- ログ内容は日本語で記録する
- これらのログはデバッグと操作履歴をローカルに保存するために残す

"エージェント名" はプレースホルダーです。Codex の AGENTS.md では "Codex"、Claude の CLAUDE.md では "Claude" に置き換えてください。

log_shell_execute: 実行後のシェルコマンドとその出力を記録します。
log_read_file: 重要なファイル読み取りについて、パスと文脈を記録します。
log_note: 調査メモ、判断内容、レビュー時の文脈を記録します。

ログの確認

何が起きたかを確認する

エージェントのセッション後、LogTraceはコマンド、ファイル読み取り、メモ、出力、プロジェクト情報を個別のエントリとして表示します。プロジェクト名は、記録されたプロジェクトルートの最後のフォルダ名から作成されます。たとえば C:\project\demo-app のようなパスは demo-app として表示され、フィルターにも使用できます。

時刻

時刻と記録された出力を含め、エージェントの操作を時系列で確認できます。

危険度

注意して確認すべきエントリを、危険度から見つけられます。

詳細表示

コマンド本文、ファイルパス、出力、メモが必要な場合は、エントリを開いて確認できます。

プロジェクト名

記録されたプロジェクトルートから作成されたプロジェクトフォルダ名を表示します。

検索とフィルター

判断レベル、操作、プロジェクト、アーカイブ状態、または一致するテキストでセッションを絞り込めます。

AI分析

自分のAPIキーを使用する

ライセンス認証後に利用できます。AI分析では、自分のAPIキーを使って任意でログを分析できます。使用するプロバイダーとモデルを選択でき、キーは利用可能な場合はOS内のセキュアストレージに保存されます。

Exchange Rate APIはオプションです。Exchange Rate APIキーを追加すると、LogTraceは推定API利用コストを好きな通貨で表示できます。

OpenAIキーを取得 Claudeキーを取得 Geminiキーを取得 Exchange Rate APIキーを取得

プロバイダー	高精度	バランス	低コスト
OpenAI	GPT-5.1	GPT-5.4 mini	GPT-5.4 nano
Claude	Claude Sonnet 4.6	Claude Haiku 4.5	利用不可
Gemini	Gemini 3.1 Pro Preview	Gemini 3 Flash Preview	Gemini 3.1 Flash-Lite Preview

トラブルシューティング

よくあるセットアップの問題を解決する

LogTraceが起動していない

デスクトップアプリが閉じているか、起動し終わっていません。 LogTraceをもう一度開き、アプリの準備が完了してからエージェントセッションを開始してください。

エージェントがMCPエンドポイントに接続できない

エージェントが間違ったエンドポイントを使用しているか、LogTraceがローカルで待ち受けていません。 LogTraceのサーバーURLを確認し、エージェントが同じMCPエンドポイントを使用していることを確認してください。

新しいエントリが表示されない

エージェントがLogTrace経由で接続されていないか、接続前にセッションを開始しています。エージェントを再接続し、新しいセッションを開始してから、簡単なコマンドを実行して記録されるか確認してください。

AI分析が表示されない

AI分析はライセンス認証とプロバイダーキー設定後に利用できます。ライセンスを認証してから、AI分析設定でプロバイダーキーとモデルを追加してください。

AI分析が失敗する

APIキー、モデル名、またはプロバイダー側のアクセス権が正しくない可能性があります。選択したプロバイダーを確認し、モデルが利用可能であることを確かめ、必要に応じてキーを更新してください。

インストーラーのダウンロードが始まらない

ブラウザがリダイレクトをブロックしたか、使用している端末が対応しているWindowsパソコンではありません。 Windowsパソコンでダウンロードページを開いてください。

サポート

お問い合わせをする

期待どおりに動作しない場合は、LogTraceのバージョン、Windowsのバージョン、エージェント名、発生した内容の簡単な説明を添えてお問い合わせください。改善案や新機能のリクエストも気軽にご連絡ください。

運営に連絡

ユーザーガイド