mcpField
H
honey-eco

honey-eco

github.com/green-ptAgent workflows34440 installsUpdated 1w ago
Repository

About honey-eco

Honey Eco is an agent skill for reporting session-level token and carbon-impact figures from the project's committed reporting scripts. It keeps measured CO₂eq separate from modelled savings and states the assumptions behind the estimate.

Key features

  1. 01Reports session output tokens and CO₂eq
  2. 02Shows modelled savings with its basis
  3. 03Uses committed EcoLogits-based scripts
  4. 04Provides an authoritative breakdown path

Use cases

  1. 01Reporting impact for the newest session
  2. 02Checking a session transcript in full mode
  3. 03Reviewing usage, embodied impact, and energy

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/green-pt/honey-for-devs --skill honey-eco

After installing, type/honey-ecoin Claude Code to confirm it loaded.

Details

From the project README

Honey Eco

Surface the numbers the carbon badge is based on. Never estimate by hand — run the committed report so the figure matches hooks/eco.js (the verified EcoLogits v0.8.2 port) exactly.

Do

Run, from the repo root — zero-dependency, reuses the same hooks/eco.js the badge uses:

node scripts/eco-session.js              # newest session
node scripts/eco-session.js --transcript PATH --mode full

Then report terse — output tokens, CO₂eq (g), and the saved line — in a line or two. Keep the exact numbers the script prints; don't round away precision.

Two numbers, two epistemic statuses — never merge them

  • CO₂eq is measured for this session: real output tokens through the EcoLogits port.
  • saved is not. It is a modelled counterfactual — how many tokens a no-Honey run would have emitted — taken from a committed bench stamp. Always pass through the basis: line the script prints (stamp, model, n, p). Never state a savings figure without it, and never re-derive one by hand.

When the script prints saved : —, no committed stamp covers this session's model. Say that. Do not extrapolate from another model's ratio — that is exactly how a tool ends up reporting savings while the invoice goes up.

For the authoritative breakdown (usage + embodied + primary energy) the user can run the Python path, which needs the real package:

pip install ecologits && python scripts/eco_report.py

Say once, don't bury

The params are speculative (Anthropic discloses none). The badge shows served impact — EcoLogits' single-stream (batch-1) ceiling divided by serving_concurrency (continuous-batching amortization); eco-session.js/eco_report.py also print the raw ceiling. State that once, briefly, then give the number. The badge renders only in Claude Code (its transcript is all Claude models).

Boundaries

Report only — don't change config or mode (that's the /honey command). The number is a range, not a meter reading; present it as one.

Comments

Markdown supported