agent-telemetry

agent-telemetry

Claude Code および Codex CLI を使った開発で、PR 単位のトークン消費効率を追跡・可視化する計測ツールの解説 site です。

このサイトは how it works（観察軸・hook 構成・データフロー）と how to use（セットアップ・運用）を提供します。CLI 仕様・データモデル・設計判断といった reference 系ドキュメントは引き続き GitHub repo の docs/ を正とします。

仕組み解説

何を観察しているか・なぜそれを選んだか

全体像（hook → JSONL → SQLite → Grafana）

どの hook がどのデータを何に使うか

Claude / Codex の transcript パースから集約まで

セットアップ

ローカルマシンへの導入（CLI・hook 登録・Grafana 設定）

サーバ送信のセットアップ（オプトイン、k8s 参考デプロイ）

reference 系ドキュメント（GitHub）

docs/spec.md — 外部契約（CLI・hook 仕様・データモデル）
docs/metrics.md — 計測フレームワーク
docs/design.md — 実装方針と設計判断