Prtokens – AIエージェントのトークンコストをPR単位で確認

Prtokens は、開発者が AI コーディングエージェント（Claude Code、Codex、OpenCode など）を利用する際に、個々の Pull Request（PR）が消費するトークン数とその推定コストを可視化するコマンドラインツールです。このツールは、エージェントのセッション転写ファイルをローカルで読み取り、トークン使用量を PR ブランチ上の各コミットに正確に関連付け、GitHub PR にコスト分析コメントを自動投稿します。

Prtokens の使用は簡単です。Node.js 22.13 以上がインストールされ、gh auth login で GitHub CLI の認証が済んでいることを確認した上で、オープン PR があるブランチで npx prtokens を実行するだけです。ツールは自動的に現在のブランチに対応する PR を検出し、ローカルのエージェント転写データを読み取り、推定コストコメントを投稿または更新します。同じコマンドを再実行すればコメントが更新され、複数のコントリビューターのデータは個別のラベル付きセクションで表示されます。

コメントは総コスト、入出力トークン数、セッション数、使用モデル、エージェント別コストを明確に表示します。さらに、各コミットのトークン消費、コスト、セッション数を示す折りたたみ可能なテーブルも含まれます。例えば、「🪙 このPRのコストは約$4.12です」と表示され、Claude Code と Codex の内訳が続きます。

基本機能に加え、Prtokens は多彩なコマンドオプションを提供します。--dry-run でコメント内容を標準出力に出力（実際の投稿はなし）、--json で完全な JSON データを出力、--verbose で詳細な診断情報を表示します。prtokens init コマンドでオプションのグローバルプリプッシュフックをインストールでき、git push のたびに自動的にコストコメントを投稿できます。また、prtokens pr create を使えば、PR 作成と同時にコメントを投稿できます。

プライバシー保護は Prtokens の核心理念です。すべての転写データはローカルで処理され、ユーザーのマシンから外部に出ることはありません。PR コメントには、集計されたトークン数、推定ドルコスト、セッション数、モデル名、および PR ですでに可視化されているコミットメタデータのみが含まれます。自動キューはリポジトリパス、リモートブランチ名、ヘッド SHA、タイムスタンプ、ジョブステータスのみを保存し、転写内容やプロンプト、コメントテキストは一切保存しません。

Prtokens は MIT ライセンスのオープンソースソフトウェアで、TypeScript と JavaScript で記述され、GitHub で複数のバージョンがリリースされています。AI コーディングツールを活用する開発チームにとって、Prtokens はコストの透明性を高め、開発プロセスにおけるリソース投入の最適化に役立ちます。