EcoLogits impact bar for Claude Code

A Claude Code status-line add-on that estimates the environmental impact of your session — energy use (kWh), greenhouse-gas emissions (kgCO₂eq) and freshwater consumption (L) — from the tokens Claude generates, using the public EcoLogits API.

It's a drop-in component, not a status line. You keep full ownership of your own statusline.sh: capture the eco bar into a variable, then drop the ${ECOLOGITS_LINE} placeholder anywhere in your own line:

your existing status line… | 🔥 0.21 kgCO₂eq | 💧 3.1 L | ⚡️ 0.4 kWh
                              └─────────── ${ECOLOGITS_LINE} ───────────┘

The impact grows live as you use Claude Code. Units auto-scale (mWh → Wh → kWh energy, mg → g → kg CO₂eq, mL → L water) so the numbers stay readable from the first token onward. Before the first response the metrics read 0. Want the model name shown too? Add model to ECOLOGITS_METRICS to get 🤖 opus-4-6 | 🔥 ….

Why a snippet?

Many people already have a customized status line. Rather than take it over, EcoLogits gives you a tiny script — ~/.claude/ecologits-bar.sh — that reads the same JSON Claude Code hands your status line and emits the impact figures. You capture its output into ${ECOLOGITS_LINE} and place it wherever you like, so nothing of yours changes except the two lines you paste.

Requirements

• bash, jq, curl
  • macOS: brew install jq (curl is preinstalled)
  • Debian/Ubuntu: sudo apt-get install -y jq curl

Install

curl -fsSL https://github.com/raw/DuarteVi/ecologits-statusline/main/install.sh | bash

Piping a remote script to bash runs code you haven't read. If you'd rather review it first: curl -fsSL …/install.sh -o install.sh && less install.sh && bash install.sh.

Or install from a local clone

git clone https://github.com/DuarteVi/ecologits-statusline.git
cd ecologits-statusline
./install.sh

The installer is non-destructive — it never edits your settings.json or any statusline.sh. It installs ecologits-bar.sh and a config file into ~/.claude, then prints the snippet to paste.

Add the bar to your status line

Your statusline.sh must capture the JSON Claude Code sends on stdin — the canonical first line does this:

input=$(cat)

Then, after input=$(cat), capture the bar into a variable and drop the ${ECOLOGITS_LINE} placeholder anywhere in your own status line:

# ─── EcoLogits impact bar — https://ecologits.ai ───
# 1) Capture the bar into a variable:
ECOLOGITS_LINE=$(printf '%s' "$input" | ~/.claude/ecologits-bar.sh)

# 2) Drop ${ECOLOGITS_LINE} anywhere in your own line, e.g.:
echo -e "...your status line... | ${ECOLOGITS_LINE}"

That's it. Start a new session — your status line stays exactly as it was, with the eco figures slotted in wherever you placed the placeholder (showing 0 until the first response lands).

Capturing with $( … ) runs entirely from a local cache, so it never adds latency. Prefer the eco bar on its own separate line below yours? Just skip the variable and pipe it directly: printf '%s' "$input" | ~/.claude/ecologits-bar.sh.

The snippet assumes your captured stdin is in a variable named input. If you named it something else, use that name instead (e.g. printf '%s' "$STDIN"). If the bar can't see the JSON it prints 🤖 EcoLogits: no input … so you can spot the mismatch.

No status line yet?

Create ~/.claude/statusline.sh:

#!/usr/bin/env bash
input=$(cat)

# ─── EcoLogits impact bar — https://ecologits.ai ───
# 1) Capture the impact bar into a variable:
ECOLOGITS_LINE=$(printf '%s' "$input" | ~/.claude/ecologits-bar.sh)

# 2) Place ${ECOLOGITS_LINE} anywhere in your own status line:
echo -e "my prompt | ${ECOLOGITS_LINE}"

Make it executable and point Claude Code at it:

chmod +x ~/.claude/statusline.sh

{
  "statusLine": { "type": "command", "command": "~/.claude/statusline.sh", "padding": 2 }
}

(Running ./install.sh prints this same starter when it detects no status line.)

How it works

• Sums output_tokens across the current session's transcript (resets each session).
• Sends that total to POST /v1beta/estimations on the public EcoLogits API and shows the midpoint of the returned energy (kWh), gwp (CO₂eq) and wcf (water) ranges.
• Never blocks your terminal: each render prints instantly from a small cache in ~/.claude/ecologits-cache/. A refresh runs in the background only when your token count grows — idle sessions make zero API calls. If a refresh fails (offline, etc.) the last-known value is kept, never blanked.

Configuration

Edit ~/.claude/ecologits.config.sh — it's sourced on every render. The two things most people change: the model (input) and which impacts to show (output).

# INPUT — the Claude model to estimate
: "${ECOLOGITS_MODEL:=claude-opus-4-6}"

# OUTPUT — impacts to display, in order (space-separated)
: "${ECOLOGITS_METRICS:=gwp wcf energy}"

Input — model

Set ECOLOGITS_MODEL to the model you actually use (default claude-opus-4-6). Valid values come from the public endpoint /v1beta/models/anthropic:

claude-opus-4-6    claude-opus-4-5    claude-opus-4-1    claude-opus-4-0
claude-sonnet-4-6  claude-sonnet-4-5  claude-sonnet-4-0
claude-haiku-4-5

Output — metrics

ECOLOGITS_METRICS is a space-separated, ordered list. Default gwp wcf energy renders 🔥 … gCO₂eq | 💧 … mL | ⚡️ … Wh. Available metrics (API docs):

key	emoji	impact	unit (auto-scaled)
gwp	🔥	Greenhouse-gas emissions	mg/g/kg CO₂eq
wcf	💧	Fresh water consumed	mL/L
energy	⚡️	Energy consumed by the request	mWh/Wh/kWh
adpe	⛏️	Mineral & metal resource depletion	µg/mg/g Sbeq
pe	🛢️	Total primary energy consumed	J/kJ/MJ

E.g. ECOLOGITS_METRICS="energy gwp wcf adpe pe" shows all five.

You can also place one context key anywhere in the list:

key	emoji	shows
model	🤖	The model being estimated (resolved id in auto mode, e.g. opus-4-6; the claude- prefix is dropped)

Put it first to label the line: ECOLOGITS_METRICS="model gwp wcf energy" → 🤖 opus-4-6 | 🔥 … | 💧 … | ⚡️ ….

Other settings

Variable	Default	Description
ECOLOGITS_ZONE	WOR	Electricity-mix zone for the server location — where the data center sits (ISO-3166 alpha-3, e.g. USA, FRA)
ECOLOGITS_API	https://api.ecologits.ai/v1beta/estimations	Estimations endpoint (point to your own deployment if you self-host)

Every setting can also be supplied as a real exported environment variable, which takes precedence over the config file.

Caveats

• Estimates, not measurements. Figures come from EcoLogits' impact model and are shown as range midpoints. See the EcoLogits methodology.
• claude-opus-4-6 is a deliberate worst-case ceiling — it's the highest Anthropic model the public API serves. If you actually run Sonnet/Haiku, the numbers overstate impact. Set ECOLOGITS_MODEL to change this.
• Electricity zone defaults to WOR (world average). The real data-center location isn't published; adjust with ECOLOGITS_ZONE if you prefer.
• Only output tokens drive the estimate (the API models impact from generation). Thinking/reasoning tokens are included, since they're generated.

Uninstall

curl -fsSL https://github.com/raw/DuarteVi/ecologits-statusline/main/uninstall.sh | bash
# add --purge to also remove ecologits.config.sh:
curl -fsSL https://github.com/raw/DuarteVi/ecologits-statusline/main/uninstall.sh | bash -s -- --purge

Or from a local clone:

./uninstall.sh          # remove the bar + cache, keep your config
./uninstall.sh --purge  # also remove ecologits.config.sh

This deletes ~/.claude/ecologits-bar.sh and the cache directory, then reminds you to remove the two pasted lines from your own statusline.sh (it won't edit your script for you).

Credits

Built on EcoLogits, part of the CodeCarbon non-profit. This project is an independent status-line integration and is not affiliated with Anthropic or with CodeCarbon.

About the name. "EcoLogits" refers to the projects of the CodeCarbon non-profit — primarily:

• ecologits — the impact-estimation library (MPL-2.0)
• ecologits-api — the public API this add-on queries (AGPL-3.0)

This add-on does not bundle or redistribute any code from those projects: it is a thin client that calls the public EcoLogits API over HTTP. It therefore carries no MPL-2.0 or AGPL-3.0 obligations — those licenses bind, respectively, anyone who copies/modifies the library's source files, or anyone who operates the API server (including if you self-host ecologits-api). "EcoLogits" is used here only to credit and point at the upstream projects.

License

MIT — see LICENSE. This covers the scripts in this repository only; the upstream EcoLogits projects keep their own licenses (see above).