carbon-badge · diff

git:20260902.8b0a84f to git:20260916.1856e36

1 added, 1 removed. Audit A to A.

---

name: carbon-badge

description: Generate a shields.io badge of your Claude Code carbon footprint for your READMEs

---

Run the following bash script and present the output to the user.

```bash

#!/usr/bin/env bash

# Locate the install wired into the status line (honours CLAUDE_CONFIG_DIR),

# then fall back to CLAUDE_PLUGIN_ROOT / CLAUDE_CARBON_DIR / the default path.

# Windows (Git Bash): CLAUDE_* variables and the paths stored in settings.json can

# arrive in the native "C:\Users\..." spelling, which bash cannot open. cygpath

# ships with Git for Windows; everywhere else this is the identity function.

ccp() {

case "${OSTYPE:-}" in msys*|cygwin*) ;; *) printf '%s' "$1"; return 0 ;; esac

case "$1" in

[A-Za-z]:[\\/]*|*\\*) cygpath -u "$1" 2>/dev/null || printf '%s' "$1" ;;

*) printf '%s' "$1" ;;

esac

}

CFG="$(ccp "${CLAUDE_CONFIG_DIR:-$HOME/.claude}")"

REPO_DIR=""

if command -v jq >/dev/null 2>&1 && [ -f "$CFG/settings.json" ]; then

SL_CMD="$(jq -r '.statusLine.command // empty' "$CFG/settings.json" 2>/dev/null)"

# statusLine.command stores a shell-escaped path: expand ~ and unescape spaces

SL_CMD="${SL_CMD//\\ / }"; SL_CMD="${SL_CMD/#\~/$HOME}"; SL_CMD="$(ccp "$SL_CMD")"

[ -n "$SL_CMD" ] && [ -f "$SL_CMD" ] && REPO_DIR="$(cd "$(dirname "$SL_CMD")/.." 2>/dev/null && pwd)"

[ -z "$REPO_DIR" ] && [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && REPO_DIR="$(ccp "$CLAUDE_PLUGIN_ROOT")"

[ -z "$REPO_DIR" ] && [ -n "${CLAUDE_CARBON_DIR:-}" ] && REPO_DIR="$(ccp "$CLAUDE_CARBON_DIR")"

if [ -z "$REPO_DIR" ]; then

# Pure marketplace installs reach here: no statusLine.command in settings.json and

# no CLAUDE_PLUGIN_ROOT in a skill's bash env. Pick the newest cached plugin copy,

# keeping only candidates that ship the badge script.

CACHE_LATEST=""

for D in "$CFG/plugins/cache"/*/claude-carbon/*/; do

[ -f "${D}scripts/generate-badge.sh" ] || continue

if [ -z "$CACHE_LATEST" ] || [ "$(printf '%s\n%s\n' "$CACHE_LATEST" "$D" | sort -V | tail -1)" = "$D" ]; then

CACHE_LATEST="$D"

done

[ -n "$CACHE_LATEST" ] && REPO_DIR="${CACHE_LATEST%/}"

[ -z "$REPO_DIR" ] && REPO_DIR="$HOME/code/claude-carbon"

bash "$REPO_DIR/scripts/generate-badge.sh"

```

- The script prints a ready-to-paste markdown snippet and the raw badge URL. Show both exactly as printed — never recompute, reformat or re-escape the number or the URL. Tell the user to paste the markdown line into any README of theirs; the badge is a static image, so re-running `/carbon-badge` is how they refresh the figure.

+ The script prints a ready-to-paste markdown snippet, the raw badge URL and a short note on where the badge belongs. Show all of it exactly as printed — never recompute, reformat or re-escape the number, the month or the URL. The badge is one developer's total, dated with the month it was generated, and it links to the methodology. It belongs in the user's profile README or a personal project, not in a team or organisation repository. The badge is a static image, so re-running `/carbon-badge` is how they refresh the figure and its month.

If the script is missing (an install that predates the badge), suggest `/carbon-update`.