Add the AI usage badge and pinned agent-badge tooling

Display aggregate token usage through the repository's public gist and make the badge CLI available in each Nix development shell. Keep refresh manual and local state out of Git.

Author: jbboehr

.github/agent-badge/config.json

@@ -0,0 +1,43 @@
+{
+  "version": 1,
+  "providers": {
+    "codex": {
+      "enabled": true
+    },
+    "claude": {
+      "enabled": true
+    },
+    "grok": {
+      "enabled": true
+    }
+  },
+  "repo": {
+    "aliases": {
+      "remotes": [],
+      "slugs": []
+    }
+  },
+  "badge": {
+    "label": "AI burn",
+    "mode": "tokens",
+    "style": "flat",
+    "color": "#E8A515",
+    "colorZero": "lightgrey",
+    "cacheSeconds": 300
+  },
+  "publish": {
+    "provider": "github-gist",
+    "gistId": "8e84087d2b366ca46922d83c53177eb7",
+    "badgeUrl": "https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2Fjbboehr%2F8e84087d2b366ca46922d83c53177eb7%2Fraw%2Fagent-badge.json&cacheSeconds=300"
+  },
+  "refresh": {
+    "prePush": {
+      "enabled": false,
+      "mode": "fail-soft"
+    }
+  },
+  "privacy": {
+    "aggregateOnly": true,
+    "output": "standard"
+  }
+}

.gitignore

@@ -9,3 +9,9 @@ result*
 /.pre-commit-config.yaml
 /coverage/
 /vendor/
+
+# agent-badge:gitignore:start
+.github/agent-badge/state.json
+.github/agent-badge/cache/
+.github/agent-badge/logs/
+# agent-badge:gitignore:end

README.md

@@ -4,6 +4,7 @@
 [![ci](https://github.com/jbboehr/phpstan-array-merge/actions/workflows/ci.yml/badge.svg)](https://github.com/jbboehr/phpstan-array-merge/actions/workflows/ci.yml)
 [![License: AGPL v3 with Romic Exception](https://img.shields.io/badge/License-AGPL_v3_with_Romic_Exception-blue.svg)](#license)
 ![stability-experimental](https://img.shields.io/badge/stability-experimental-orange.svg)
+[![AI burn](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2Fjbboehr%2F8e84087d2b366ca46922d83c53177eb7%2Fraw%2Fagent-badge.json&cacheSeconds=300)](https://github.com/arlegotin/agent-badge)
 
 ## Installation
 

flake.lock

@@ -23,6 +23,11 @@
     nixpkgs-php81.url = "github:nixos/nixpkgs/nixos-25.05";
     systems.url = "github:nix-systems/default";
 
+    agent-badge = {
+      url = "github:jbboehr/agent-badge.ts/master";
+      inputs.nixpkgs.follows = "nixpkgs";
+    };
+
     git-hooks = {
       url = "github:cachix/git-hooks.nix";
       inputs.nixpkgs.follows = "nixpkgs";
@@ -35,6 +40,7 @@
       nixpkgs,
       nixpkgs-php81,
       systems,
+      agent-badge,
       git-hooks,
     }:
     let
@@ -84,6 +90,7 @@
             in
             pkgs.mkShell {
               packages = pre-commit-check.enabledPackages ++ [
+                agent-badge.packages.${system}.default
                 pkgs.mdl
                 php'
                 php'.packages.composer