mcpField
A
agent-pulse

agent-pulse

github.com/jane-o-o-o-oエージェントワークフロー147.5k 回インストール22 週間前に更新
リポジトリ

agent-pulse について

agent-pulseは、agent-pulse CLIでローカルのAIエージェントの活動、コスト、傾向を調べるためのスキルです。コマンド選択、結果の解釈、JSONを使ったレポート作成を案内します。

主な機能

  1. 01CLIコマンド選択の案内
  2. 02セッションと利用状況の分析
  3. 03コストと傾向の確認
  4. 04プラットフォーム・期間の絞り込み
  5. 05JSONレポートとエクスポート
  6. 06MCPツール利用の案内

活用シーン

  1. 01最近のエージェントセッションの要約
  2. 02モデルのコストと利用状況の比較
  3. 03ローカル活動データの欠落調査
  4. 04監視用またはエクスポート用レポートの作成

MCP 対応

他のAIクライアントから状態、予測、セッション、モデル分析、最適化、ヘルスチェック、検索、リーダーボードなどを照会するためのagent-pulse MCPモードの利用方法を説明します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jane-o-o-o-o/agent-pulse-skill --skill agent-pulse

インストール後、Claude Code で/agent-pulseを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yamlscripts/run_agent_pulse_snapshot.py

詳細

Agent Pulse

目的

ローカルの AI エージェントのアクティビティを確認する際は、インストール済みの agent-pulse CLI を信頼できる情報源として使用します。PyPI パッケージ名は agentpulse-cli ですが、コマンド名は引き続き agent-pulse です。Agent Pulse のソースコードを読むより、コマンドを実行して出力を要約してください。

Agent Pulse の出力には絵文字や罫線文字が含まれるため、Windows ではコマンドを実行する前に、必ず UTF-8 を有効にしてください。

$env:PYTHONUTF8='1'
$env:PYTHONIOENCODING='utf-8'

agent-pulse が PATH にない場合は、依存関係をインストールする前にユーザーに確認してください。ユーザーの承認を得た場合は、PyPI パッケージをインストールするか、ローカルのプロジェクトチェックアウトからの実行を試してください。

pip install agentpulse-cli

python -m agent_pulse.cli --version

ソースキー

ユーザーがすべてのローカルデータではなく、特定のエージェントツールについて尋ねた場合は、-P/--platform を使用してください。

hermes, claude, codex, deepseek, openclaw, copilot, aider, qwen,
opencode, goose, cursor, antigravity, amp

コマンドの選択

まず、このコマンド選択表を使用してください。

ユーザーの要望実行するコマンド
現在の状況agent-pulse status --json
ダッシュボード全体agent-pulse --json または agent-pulse --no-banner
デモデータagent-pulse demo --json
セットアップの診断agent-pulse doctor --json
最近のセッションagent-pulse --json --hours 24 --limit 20
トークン数の多いセッションagent-pulse top --sort tokens --json
コストの高いセッションagent-pulse top --sort cost --json --hours 168
モデルのコスト分析agent-pulse models --json
モデルのランキングagent-pulse leaderboard --json --rank-by efficiency
コスト削減agent-pulse optimize --json
予算状況agent-pulse budget --json
コスト予測agent-pulse forecast --json
コストの異常チェックagent-pulse anomaly --json
ヘルス／CI チェックagent-pulse health --json
複合スコアagent-pulse score --json
セッションの検索agent-pulse search "<query>" --json
期間の比較agent-pulse compare --json
プロジェクトの比較agent-pulse compare-projects --json
アクティビティカレンダーagent-pulse heatmap --json
スマートレコメンデーションagent-pulse insights --json
Prometheus メトリクスagent-pulse metrics --format prometheus
レポートのエクスポートagent-pulse export -f markdown または agent-pulse export-html
Web ダッシュボードagent-pulse web --port 8765
REST APIagent-pulse api --port 8766
MCP ツールagent-pulse mcp --list-tools

インストール済みのコマンドでオプションが使えない場合は、agent-pulse <command> --help を実行して、適宜調整してください。

ワークフロー

  1. データが欠落している理由をユーザーが尋ねた場合、セットアップのサポートを求めた場合、または通常のデータコマンドでセッションが返されない場合に限り、最初に agent-pulse doctor --json を実行してください。
  2. 可能な限り JSON 出力を使用してください。重要なフィールドを要約します。セッション数、トークン数、ツール、検索呼び出し数、モデル別の内訳、ソース別の内訳、推定コスト、警告などです。
  3. 対象を絞った質問には時間フィルターを使用してください。「最近」はデフォルトで過去 24 時間、「今週」は 168 時間とします。
agent-pulse status --json --hours 24
agent-pulse --json --hours 168 --limit 50
  1. 特定のエージェントシステムについて尋ねられた場合は、プラットフォームフィルターを使用してください。
agent-pulse --json -P codex --hours 24
agent-pulse --json -P claude --hours 24
agent-pulse top --json -P aider --sort cost
agent-pulse status --json -P cursor
  1. コストに関する質問では、概要、モデル、上位セッションの各ビューを組み合わせてください。
agent-pulse status --json --hours 24
agent-pulse models --json --hours 24
agent-pulse top --sort cost --json --hours 24
agent-pulse optimize --json --hours 168
  1. 傾向やリスクに関する質問では、予測／履歴／比較／異常検出を使用してください。
agent-pulse forecast --json
agent-pulse history --json
agent-pulse compare --json
agent-pulse anomaly --json
  1. セットアップでは、パスを推測する前に検出コマンドを使用してください。
agent-pulse doctor --json
agent-pulse scan --json --details
agent-pulse config show

結果の解釈

  • total_cost_usd は、Agent Pulse のローカルなモデル料金表に基づく推定値として扱ってください。
  • コストとトークン量の両方を報告してください。低コストのモデルでも、トークン使用量が非常に多い場合があります。
  • codex、claude、hermes、deepseek、openclaw、aider、cursor、opencode、goose などのソースを区別してください。
  • doctor で、任意ソースの欠落、dev_root の欠落、または任意の Web 依存関係が報告された場合は、その旨を伝えてください。
  • セッションが表示されない場合は、doctor を確認してから、--hours 168 など、より広い時間範囲を試してください。
  • 全体の合計を提示する前に、ユーザーがソース（-P）フィルター、モデルフィルター、またはプロジェクト比較を指定していないか確認してください。
  • コマンドが JSON ではなくプレーンテキストを出力する場合、またはインストール済みバージョンが古くて失敗する場合は、agent-pulse <command> --help を実行し、最も近い対応オプションを使用してください。

レポート

短く読みやすい回答には、JSON コマンドを実行して要約します。

成果物には、次を優先してください。

agent-pulse report --period daily
agent-pulse export -f markdown
agent-pulse export-html

正確な削減額やコストをでっち上げないでください。CLI の出力を使用してください。

インテグレーション

ユーザーがブラウザーダッシュボードまたはプログラムから利用できるサーバーを求めた場合に限り、Web と API の追加機能を使用します。不足している追加機能をインストールする前に、確認してください。

pip install "agentpulse-cli[web]"
agent-pulse web --port 8765
agent-pulse api --port 8766

監視パイプラインには、次を使用してください。

agent-pulse metrics --format prometheus
agent-pulse health --cost-limit 100 --token-limit 1000000 --json

MCP

ユーザーが他の AI クライアントから Agent Pulse にクエリを実行したい場合は、MCP モードを使用してください。

agent-pulse mcp --list-tools
agent-pulse mcp

MCP について説明するときは、ステータス、予測、上位セッション、モデル分析、最適化、ヘルス、検索、リーダーボードなどのツールを公開することを伝えてください。

ローカルヘルパー

このスキルには、JSON で扱いやすい Agent Pulse のチェックを簡潔にまとめて実行し、統合サマリーを出力する scripts/run_agent_pulse_snapshot.py が含まれています。

python scripts/run_agent_pulse_snapshot.py --hours 24 --days 7

コメント

Markdown 対応