waybill
Waybill
領収書をお持ちください。 WaybillはAI支援作業のトークン会計ツールです。Claude Codeのプラグインとして、すべてのトークンを計測し、それを出荷先のJiraストーリーに紐付け、価値レポート、業績評価パッケージ、そして厳しい審査に耐えうるトークン予算要求に変換します。
*ウェイビル(waybill)*とは、貨物とその料金を明細化する運送書類です。あなたが出荷すれば、Waybillがその明細記録を保持します。
なぜ必要か
エンジニアの1年を左右する2つの会話があり、どちらも同じ不完全な情報に基づいています:
「AI予算の価値は何だったのか?」 — 多くのチームは、実証された価値に基づいてClaudeトークンを割り当てます。うまく活用し、それを示せば、より多くのトークンを得られます。
「今期は何を達成したのか?」 — 業績評価、昇進パッケージ、スプリントレビュー。
人間はどちらも記憶と形容詞に頼り、前日の夜に回答します。判断する側は、正直な主張と誇張された主張を見分けられないため、すべてを割り引いて評価します。Waybillは証拠を修正します。説得ではありません。作業が発生したときに記録し、すべての主張をPR、課題、デプロイタグ、トランスクリプトなどの成果物に結び付け、次回の提案が無視されるような主張をさせないようにします。
Related MCP server: MCP Token Tracker
最初の領収書まで60秒
claude plugin marketplace add Jakeintech/waybill
claude plugin install waybill@waybill次に、Claude Codeセッションで 「ウェイビル元帳を初期化して」 と言ってください。これで設定は完了です。アカウントもトークンもOAuthも不要です。Waybillはgit configからあなたのIDを取得し、Anthropicの価格表レートをインポートして初日からコストを表示し、トランスクリプト保存設定を確認し、ローカルのgit履歴のみからブートストラップ領収書をレンダリングします。あなたが出荷した作業が、1分足らずで明細化されます。
アップデート
Claude Codeはプラグインのアップデート通知をプッシュしません。アップデートは、好きなときに1つのコマンドで行います:
claude plugin update waybill@waybillその後、Claude Codeを再起動してください。waybill status(またはwaybill --version)で実行中のエンジンバージョンが表示されます。Waybillは決して自分でアップデートを確認しません。あなたが要求しなければネットワーク呼び出しを行わないことはコミットメントであり、見落としではありません。リリースと変更履歴はリリースページにあります。GitHubからのメール通知をご希望の場合は、リポジトリをウォッチ(Watch → Custom → Releases)してください。
アップグレードパス(オプション、5分)
トラッカーとgitホストを接続すると、コミットがストーリーポイント、エピック、マージタイムスタンプ付きの領収書に変わります:
# Easiest — reuse your authenticated gh CLI:
export GITHUB_MCP_PAT="$(gh auth token)"
# Or mint a fine-grained read-only PAT (repos/PRs) at
# https://github.com/settings/personal-access-tokens and export it instead./mcp→atlassianのOAuthフローを完了します(トークンは不要)。「元帳を同期して、ブートストラップレポートを表示して」 と言ってください。
何が接続されていて何が接続されていないかわからない場合、waybill statusがそれを表示し、不足しているものを修正するための正確なコマンドを出力します。
これにより、過去約90日間のあなた自身の課題とマージされたPRがインポートされ、事実のみのレポート(出荷されたアイテム、ポイント、PR、デプロイ)が生成されます。習慣を1つも変える必要はありません。その後、元帳を介してタスクを開くことで、より強力な主張(以下のティアを参照)が可能になります。
仕組み
タイミング | 何が起こるか |
タスクを開始する |
|
作業する |
|
マージされる |
|
どこに行ったか知りたい |
|
主張を裏付ける必要がある |
|
すべてのClaude Codeトークンは、ローカルのトランスクリプトから決定論的に計測され、それが提供したストーリーに帰属されます。イベントごとのリゾルバー名と信頼度、保存チェック(セッションごとにΣ帰属 = Σ観測)、waybill verifyでオフラインで再実行可能、曖昧な残り用の帰属受信箱、ストーリーごとの無駄診断(トークンが何を購入したか、そしてリトライループで何を無駄にしたか)が含まれます。1.0時点でスキーマは固定されています。領収書が契約です。
証拠のティア(全体のアイデア)
レポート内のすべての数値は、その出典を示します:
事実 — マージタイムスタンプ、デプロイタグ、ストーリーポイント、トークン数。
ベースライン差分 — Claude導入前のあなた自身のベロシティ/サイクルタイムと現在の比較。
事前登録された見積もり — 作業前に記録され、範囲として報告されます。
事後的な判断 — 元帳に保持され、デフォルトではピッチから除外されます。
さらに、構造的な正直さ:追加専用ストレージ(修正は上書きではなく優先)、範囲は決して中間点に集約されず、マージまたはデプロイされた場合にのみ価値がカウントされ、コスト(消費トークン、手戻り)はすべてのピッチに表示されます。完全なルール:方法論。
レポートプリセット
token-pitch— 要求、領収書、支出元帳、効率トレンド、予測。perf-review— レビュー期間のエピックレベルの成果(レビュー/インシデント/ドキュメント作業を含む)。sprint-recap/quarterly— 継続的な記録。
レポートは3つのオーディエンスレベル(self、internal、external)でレンダリングされ、組織外に出る前に決定論的な仮名化が行われます。
Waybillが決して行わないこと
マネージャーモードや監視はありません。 あなたに割り当てられた課題と、あなたが作成したPRのみを照会します。
同僚のランキングはありません。 方法論は、設計上、個人の同僚比較を拒否します。あなたはデイブではなく、自分のベースラインと競争します。
ホスト型サービスやテレメトリーはありません。 すべては
~/.waybill/(あなたが所有するローカルgitリポジトリ)に保存されます。時間追跡はありません。 成果と見積もりを記録し、キーストロークは記録しません。
これらはギャップではなくコミットメントです。ROADMAP.mdを参照してください。
一時停止、静音化、削除
作業を記録するツールへの信頼には、それを停止する正確な方法を知っていることも含まれます。停止から完全削除までの完全な出口パス:
計測を一時停止(クライアントエンゲージメント、共有マシン、デバッグ):
~/.waybill/config.jsonで"metering": { "enabled": false }を設定します。一時停止中は何もキャプチャまたは計測されません。waybill statusはmetering: PAUSEDと報告するため、状態が黙っていることはありません。既存のデータはそのままです。元に戻して再開します。発言を減らす:
"notices": { "level": "minimal" }は、予算しきい値の行のみを保持します("off"はWaybillが自発的に言うすべてを黙らせます。計測は引き続き実行されます)。更新リマインダー(budgets.renewal_reminder_days、デフォルト14)も同じスイッチに従います。データを持ち出す:
waybill export --format json(またはcsv)で支出元帳を出力します。元帳全体はすでに~/.waybill/内のプレーンなJSONLです。あなたが所有するローカルgitリポジトリです。どこにでもコピーできます。独自仕様のものはありません。ツールをアンインストールし、データを保持:
claude plugin uninstall waybill@waybillを実行し、Claude Codeを再起動します。フックとスキルは削除されます。~/.waybill/はあなたのままです。すべてを削除:
rm -rf ~/.waybill(または$WAYBILL_HOMEを設定している場合はそれ)。これが全フットプリントです。Waybillは他の状態を保持しません。~/.claude/以下のセッショントランスクリプトはClaude Codeに属し、Waybillには属さず、そのcleanupPeriodDays設定によって管理されます。
代替手段との比較
メモリ/スプレッドシートの自慢ドキュメント | 組織管理ダッシュボード | Waybill | |
発生時にキャプチャ | ✗ | ✓ | ✓ |
PR/課題/デプロイに紐付け | ✗ | 部分的 | ✓ |
正直な反事実 | ✗ | ✗ | ✓ (事前登録、範囲指定) |
ボトムアップであなたのために機能 | ✓ | ✗ | ✓ |
ローカルに所有するデータ | ✓ | ✗ | ✓ |
ドキュメント
チュートリアル:このREADMEのクイックスタート(上記)。
リファレンス:元帳エントリと設定スキーマ · スキルリファレンス · テスト計画 — Claudeが読むドキュメントは、あなたが読むドキュメントと同じです。
解説:価値測定方法論 · ロードマップとスコープ · ブランドとボイス · スキーマ固定と移行ポリシー
仕様:完全な製品仕様書 — 出荷されたエンジンが実装する規範的な設計。
FAQ
JiraやGitHubがなくても動作しますか? はい。それがデフォルトです。Gitのみのモードは設定も認証も不要です。計測、ブランチ/pinによる帰属、ブートストラップ領収書はすべてローカルデータから実行されます。トラッカー/gitホストを接続すると領収書がアップグレードされます。MCPサーバーを持つものはどれでも交換可能です(アダプター)。
会社がトークンを配給していない場合でも、業績評価に使用できますか? はい。それがperf-reviewプリセットです。トークンピッチは元帳の出力の1つであり、目的ではありません。
私のデータはプライベートですか? ホームディレクトリ以下のローカルJSONLです。唯一のネットワーク呼び出しは、あなたが承認したMCP呼び出しであり、あなた自身のアイテムに限定されます。
なぜチームメイトと比較してくれないのですか? ストーリーポイントは人によって比較可能ではなく、同僚のスクレイピングは監視と見なされ、あなた自身の軌跡の方がいずれにせよ強力な証拠です。(方法論 §6)
マネージャーにAI支出を正当化するにはどうすればよいですか? syncを実行し、次に「トークンピッチを作成して」と言ってください。1ページの資料を持参し、フォローアップの質問に備えて元帳を保持してください。
貢献
IssueとPRは歓迎します。CONTRIBUTING.md、ロードマップ、およびgood first receiptラベルの付いたIssueを参照してください。他のトラッカー用のアダプター設定が最も求められている貢献です。行動規範をお読みください。セキュリティ報告はSECURITY.mdを通じて行ってください。
ライセンス
This server cannot be deployed
Maintenance
Related MCP Connectors
Exact Claude API cost calc with real cache economics, plus a tiktoken-misuse scanner.
FinOps agent MCP: allocated AWS, GCP, Azure, Kubernetes, SaaS & AI cost for Claude or any agent
Billable-hours time tracking with rates and CSV export, running inside Claude or Cursor.
GA4, Google Ads and Search Console in Claude. Read-only OAuth, multi-account for agencies.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceProvides intelligent analysis of token usage patterns and optimization recommendations to improve efficiency and reduce costs in Claude Code sessions. Offers real-time analysis, cost metrics, and actionable insights for better context window and tool usage optimization.3 npm-
- AlicenseNot gradedqualityDmaintenanceTracks token usage and records coding sessions for Claude Desktop users, supporting both local SQLite and cloud Cloudflare D1 databases.221 npmMIT
- AlicenseNot gradedqualityCmaintenanceAutomatically tracks AI-assisted work sessions, code changes, and commands in Claude Code or Codex CLI, and provides daily stats, weekly reports, and data export through MCP tools.23 npmMIT
- AlicenseNot gradedqualityDmaintenanceClaude Code token usage and cost visibility for MCP-capable agents.22 npmMIT