Skip to main content
Glama

Waybill

領収書をお持ちください。 WaybillはAI支援作業のトークン会計ツールです。Claude Codeのプラグインとして、すべてのトークンを計測し、それを出荷先のJiraストーリーに紐付け、価値レポート、業績評価パッケージ、そして厳しい審査に耐えうるトークン予算要求に変換します。

*ウェイビル(waybill)*とは、貨物とその料金を明細化する運送書類です。あなたが出荷すれば、Waybillがその明細記録を保持します。

CI License: MIT Claude Code plugin

なぜ必要か

エンジニアの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.
  1. /mcp → atlassianのOAuthフローを完了します(トークンは不要)。

  2. 「元帳を同期して、ブートストラップレポートを表示して」 と言ってください。

何が接続されていて何が接続されていないかわからない場合、waybill statusがそれを表示し、不足しているものを修正するための正確なコマンドを出力します。

これにより、過去約90日間のあなた自身の課題とマージされたPRがインポートされ、事実のみのレポート(出荷されたアイテム、ポイント、PR、デプロイ)が生成されます。習慣を1つも変える必要はありません。その後、元帳を介してタスクを開くことで、より強力な主張(以下のティアを参照)が可能になります。

仕組み

タイミング

何が起こるか

タスクを開始する

logがClaudeなしの見積もりを最初に記録します(事前登録)。SHA-256エスクローハッシュで封印されます。

作業する

SessionEndフックがセッションをキューに入れ、依存関係のない独立したマイナーがトランスクリプトから実際のトークン使用量を計測します。モデル呼び出しもネットワークもなく、ブロックすることもありません。

マージされる

syncが元帳をJiraの課題とGitHubのPR(またはLinear、GitLab、プレーンなローカルgit)と照合します。

どこに行ったか知りたい

spendがストーリー/エピック/モデル/週ごとに回答し、帰属受信箱を1タップずつ整理し、予算ペースを追跡します。80%/100%で1行表示し、しつこくはしません。

主張を裏付ける必要がある

reportが1ページの領収書付きピッチを構築します。forecastが、あなた自身の計測済みトークン/ストーリーポイントから次のトークン要求額を算出します。

すべてのClaude Codeトークンは、ローカルのトランスクリプトから決定論的に計測され、それが提供したストーリーに帰属されます。イベントごとのリゾルバー名と信頼度、保存チェック(セッションごとにΣ帰属 = Σ観測)、waybill verifyでオフラインで再実行可能、曖昧な残り用の帰属受信箱、ストーリーごとの無駄診断(トークンが何を購入したか、そしてリトライループで何を無駄にしたか)が含まれます。1.0時点でスキーマは固定されています。領収書が契約です。

証拠のティア(全体のアイデア)

レポート内のすべての数値は、その出典を示します:

  1. 事実 — マージタイムスタンプ、デプロイタグ、ストーリーポイント、トークン数。

  2. ベースライン差分 — Claude導入前のあなた自身のベロシティ/サイクルタイムと現在の比較。

  3. 事前登録された見積もり — 作業前に記録され、範囲として報告されます。

  4. 事後的な判断 — 元帳に保持され、デフォルトではピッチから除外されます。

さらに、構造的な正直さ:追加専用ストレージ(修正は上書きではなく優先)、範囲は決して中間点に集約されず、マージまたはデプロイされた場合にのみ価値がカウントされ、コスト(消費トークン、手戻り)はすべてのピッチに表示されます。完全なルール:方法論。

レポートプリセット

  • 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/課題/デプロイに紐付け

✗

部分的

✓

正直な反事実

✗

✗

✓ (事前登録、範囲指定)

ボトムアップであなたのために機能

✓

✗

✓

ローカルに所有するデータ

✓

✗

✓

ドキュメント

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を通じて行ってください。

ライセンス

MIT

Related MCP Connectors

Related MCP Servers