AI Eco Meter

English · Português

English

A VS Code extension that shows, in a fun and mindful way, how much energy, water and CO₂ your AI usage consumes, along with tokens, requests and averages. A little mascot planet reacts to your daily usage: radiant when it's light, overheated when you blow past your daily goal.

Features

• Dashboard with an animated mascot planet, battery and water-glass gauges, token breakdown (input / output / cache), requests, averages, CO₂ and peak hour.
• "That's the same as…": phone charges, LED-bulb hours, video streaming, microwave time, glasses of water, shower seconds, km driven, tree-days of CO₂ absorption, each with its own animated illustration.
• Where the energy goes: shows that reading from cache is cheap and generating text is expensive.
• History by hour (today) or by day (7 / 30 days / all time), per-model breakdown, mindful tips that adapt to your real usage, and pixel-art achievements.
• Pixel-art pets (cat, capybara, duck, dog, turtle, crab…) strolling at the bottom of the dashboard, in a Pets tab in the bottom panel and in the Explorer. Click one to hear a comment about your day.
• Planet Yard, an idle game in the Pets tab: the pets grow plants and harvest seeds on their own. The big goal is to restore Brazil's biomes (Cerrado, Caatinga, Pantanal, Atlantic Forest and Amazon) by planting trees; each one changes the scenery, brings a native animal (giant anteater, armadillo, hyacinth macaw, golden lion tamarin, jaguar) and gives a permanent bonus. There are daily missions (one of them always tied to mindful AI use). The pace follows your AI usage: a light day yields up to +50%, a heavy day slows everyone down (−30%), and you never lose progress.
• Status bar with today's usage.
• Português and English: set aiEcoMeter.language (automatic follows the VS Code display language).

Where the data comes from

No data leaves your computer. Logs are read incrementally, so only new lines are processed on each refresh.

How it's calculated

Energy (Wh) = tokens ÷ 1000 × coefficient × model factor. Defaults per 1,000 tokens: output 1.0 Wh, input 0.1, cache write 0.12, cache read 0.01. Model factors: haiku/mini/flash ×0.35 · sonnet ×1 · opus ×2 · fable ×3. Water = energy × 1.8 L/kWh · CO₂ = energy × 400 g/kWh.

These are order-of-magnitude estimates: no provider publishes exact energy use per token. References used for calibration: Google (2025), median Gemini prompt ≈ 0.24 Wh and 0.26 mL of water; Epoch AI (2025), typical GPT-4o query ≈ 0.3 Wh; Mistral (2025, Mistral Large 2 life-cycle analysis), 400-token response ≈ 45 mL of water and 1.14 g CO₂e (including training). Every coefficient can be adjusted under Settings → AI Eco Meter.

Install

Search for AI Eco Meter in the Extensions view (VS Code Marketplace, or Open VSX for Antigravity, Cursor and Windsurf), or run:

code --install-extension pmxtecnologia.ai-eco-meter

Support

AI Eco Meter is free and open source. If it helps you, you can support its development with a donation via PayPal. Totally optional: every feature stays free.

Português

Uma extensão para VS Code que mostra, de um jeito divertido e consciente, quanta energia, água e CO₂ o seu uso de inteligência artificial consome, junto com tokens, requisições e médias.

Um planetinha mascote reage ao seu consumo do dia: fica radiante quando o uso está leve e com calor quando a meta diária estoura.

O que tem

• Bichinhos em pixel art passeando no rodapé: gato, capivara (com laranjinha na cabeça), pato, cachorro, tartaruga e caranguejo. Eles andam, sentam e cochilam. Clique num deles para ele pular e comentar seu consumo do dia. Em dia quente, suam e andam mais devagar. No painel completo eles ficam maiores.
• Aba e seção "Bichinhos": os bichinhos também moram numa aba no painel de baixo (junto do Terminal) e numa seção no fim do Explorer. Deixe a aba bem fininha e eles ficam passeando no cantinho enquanto você trabalha. Para esconder, clique com o botão direito no título e escolha Ocultar.
• Bichinhos dentro do editor (experimental, desligado): aiEcoMeter.pets.inEditor coloca versões pequenas depois do código da última linha visível. Como a API do VS Code não permite fixá-los na borda da janela, eles acompanham a rolagem.
• Quintal do planeta (jogo idle na aba Bichinhos): os bichinhos cultivam canteiros e colhem sementes sozinhos. O grande objetivo é restaurar os biomas brasileiros (Cerrado, Caatinga, Pantanal, Mata Atlântica e Amazônia) plantando árvores: cada um muda o cenário, traz um bicho típico e dá bônus permanente, e depois vem uma nova volta. Há missões do dia (uma delas sempre ligada ao uso consciente de IA) e uma loja sem limite de níveis. O ritmo acompanha o seu uso de IA: dia leve rende até +50%, dia pesado deixa todo mundo com calor (−30%), sem nunca perder progresso. O progresso continua (pela metade) com o VS Code fechado, por até 8 h.
• Planeta mascote animado: pisca, flutua e muda de humor (radiante → tranquila → preocupada → com calor). As turbinas eólicas giram mais rápido quando o consumo está baixo. Clique no planeta para ouvir outra frase.
• Bateria e copo d'água animados: se enchem conforme a energia e a água gastas, em relação à sua meta.
• Métricas: tokens (entrada/saída/cache), requisições, média de tokens por requisição e por dia, CO₂ e horário de pico.
• "Isso equivale a…": cargas de celular, horas de lâmpada LED, streaming, micro-ondas, copos d'água, segundos de chuveiro, km de carro, dias de uma árvore absorvendo CO₂. Cada item tem sua ilustração animada.
• Para onde vai a energia: mostra que ler do cache é barato e que gerar texto é caro.
• Histórico por hora (hoje) ou por dia (7 / 30 / todos os dias), com linha de meta e tooltips.
• Por modelo: quais modelos consomem mais.
• Dicas conscientes que se adaptam ao seu uso real.
• Conquistas com medalhas em pixel art: Primeira gota, Mestre do cache, Dia zen, Semana verde, Coruja…
• Barra de status com o consumo de hoje (clique para abrir o painel).

De onde vêm os dados

Nada sai do seu computador. A leitura é incremental: só as linhas novas são processadas a cada atualização.

Como calculamos

Energia (Wh) = tokens ÷ 1000 × coeficiente × fator do modelo

Fatores de modelo: haiku/mini/flash ×0,35 · sonnet ×1 · opus ×2 · fable ×3. Água = energia × 1,8 L/kWh · CO₂ = energia × 400 g/kWh.

São estimativas de ordem de grandeza. Nenhum provedor publica o consumo exato por token. Referências usadas para calibrar:

• Google (2025): prompt mediano do Gemini ≈ 0,24 Wh e 0,26 mL de água
• Epoch AI (2025): consulta típica ao GPT-4o ≈ 0,3 Wh
• Mistral (2025, ciclo de vida do Mistral Large 2): resposta de 400 tokens ≈ 45 mL de água e 1,14 g CO₂e (inclui treino)

Todos os coeficientes são ajustáveis em Configurações → AI Eco Meter.

Configurações

Instalar

code --install-extension pmxtecnologia.ai-eco-meter

Ou, para desenvolver: abra esta pasta no VS Code e aperte F5 (não precisa de npm install, é JavaScript puro, sem dependências).

Para gerar o .vsix (use sempre a ferramenta oficial para publicar nas lojas): npx @vscode/vsce package --no-dependencies.

Apoie

O AI Eco Meter é gratuito e de código aberto. Se ele te ajuda, você pode apoiar o desenvolvimento com uma doação pelo PayPal. É totalmente opcional: todos os recursos continuam gratuitos.