spendtron

spendtron

GitHub Actions のワークフローのうち、CI の請求額を押し上げているものを特定し、実際のコンピューティングコストに基づいてワークフローとリポジトリをランキング表示する、読み取り専用ツールです。キャッシュの不足や timeout-minutes の未設定などについて、実際の実行時間に基づいて確認された、貼り付けて使える修正差分を提案します。推定値ではありません。

MCP サーバーとして提供されます。Claude、ChatGPT、または MCP 互換クライアントから check_actions_cost を呼び出せます。ダッシュボードは不要です。認証には GitHub App（読み取り専用：Actions、Contents、Metadata）と spendtron API キーを使い、ベアラートークンとして渡します。コストランキングと、確認済みの修正差分 1 件は毎回無料です。修正リスト全体のロック解除は、Stripe を介した 1 回限りの 39 ドルの支払いです。サブスクリプションではありません。

基盤となる監査ロジックは、~/code/ci-audit/actions-teardown.sh（bash + gh api）として始まりました。lib/auditActions.js は同じアルゴリズムを移植したもので、ローカルで gh 認証した 1 人のユーザー向けではなく、多数の顧客組織をインストールごとに監査できるようにしています。

ステータス

ウェイティングリストではなく、実際のプロダクトです。ここに至るまでの経緯については、~/code/ci-audit の HANDOFF.md／FINDINGS.md／CARRD.md を参照してください（以前の、ウェイティングリストを作って Reddit に投稿する試みは適切に中止されました。監査ロジック自体は最初から実際に動作するものでした）。

誰でも GitHub に接続できるようにするには、GitHub App を公開する必要があります（GitHub → spendtron-app → Advanced → Make this GitHub App public）。この切り替えはこのリポジトリではなく、GitHub の UI で行います。

セットアップ

1. .env.example を .env.local にコピーします（または、本番環境では Cloud Run の Secret Manager にこれらを設定します）。
2. github.com/settings/apps/new で GitHub App を作成します。スラッグは spendtron-app、権限は Actions: Read-only、Contents: Read-only、Metadata: Read-only です。コールバック URL は <your deployed host>/github/callback にします。顧客を /github/install に案内する前に、App を公開してください。
3. Neon Postgres データベースを作成し、db/schema.sql を実行します。
4. 修正差分のロック解除用に、1 回限りの Stripe Price（継続課金ではないもの）を作成し、その ID を STRIPE_UNLOCK_PRICE_ID に設定します。checkout.session.completed の Stripe webhook を /stripe/webhook に向けます（STRIPE_PRICE_ID と Customer Portal は、以前の月額 99 ドルモデルの名残です。現在は、稼働中のチェックアウトフローでは使われていません）。
5. spendtron.com と www.spendtron.com の両方を Cloud Run サービスにマッピングします（Squarespace で www を ghs.googlehosted.com に CNAME で設定します）。アプリは www から apex へ 301 リダイレクトします。
6. Stripe 用のプライバシーポリシー／利用規約は、https://spendtron.com/privacy と https://spendtron.com/terms です。
7. npm install && npm start

テスト

npm test — モックした GitHub クライアントを使い（これらのテストに実際の認証情報は不要です）、コスト計算の移植版（actions-teardown.sh の bash/awk と完全に一致する必要があります）と API キー認証をテストします。