Back to directory

dsh-green-meter

Curated pickMaintenance: Active

dclichang2022/dsh-green-meter

Desktop app for DeepSeek Harness with a live energy/carbon console: measure local GPU inference, estimate cloud APIs via published coefficients, alert on waste

View on GitHubHomepage
$ dsh web

97

stars

0

forks

JavaScript

Language

MIT

License

2026-08-14

Created

2026-09-10

Last push

MIT-licensed dsh-plugin with native DeepSeek Harness integration: per-turn/per-request energy, carbon, electricity cost and cache carbon savings, surfaced via a composer dock, detail panel, `/green` command and `green_meter` tool.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-28

License

MIT

01What can it help you accomplish?

  • See live energy, carbon and electricity cost of DeepSeek Harness sessions

    a live `能耗 1.5 kJ · 碳 0.2 g` readout under the composer with a per-turn energy sparkline; a draggable detail drawer with per-turn energy chart, per-request energy list, session totals and cache carbon savings

    DSH users and green-AI minded developers who want real-time visibility into what their agentic sessions cost

  • Produce a session energy report and make the agent energy-aware

    a one-command `/green` session energy report; `green_meter` tool access so the agent can query energy, carbon, cost and budget; an optional per-session energy budget

    DSH users who want the agent itself to track its own energy use and enforce per-session limits

02How to install into DeepSeek Harness

Prerequisites

  • A dsh profile with the `web` app — the README's install commands target `~/.dsh/profiles/web`
  • `pnpm` — the README installs via `pnpm add dsh-green-meter dsh-client-ui-green-meter`

Installation steps

  1. 01

    Change into your dsh profile directory: `cd ~/.dsh/profiles/web` (Windows: `%USERPROFILE%\.dsh\profiles\web`)

  2. 02

    Install the two packages: `pnpm add dsh-green-meter dsh-client-ui-green-meter`

  3. 03

    Mount both plugins in the profile's `cordis.patch.yml` — `green-meter` (`dsh-green-meter`) and `ui-green-meter` (`dsh-client-ui-green-meter`, with `panelPlacement: overlay`)

  4. 04

    Restart `dsh web` and refresh

    $ dsh web

Verify the integration

  • Restart `dsh web`, refresh — the readout appears under the composer, and `/green` works anytime

03DSH integration and capability boundaries

DSH integrationNative runtime

Native dsh runtime — installed into the dsh profile (`~/.dsh/profiles/web`) via pnpm, mounted in `cordis.patch.yml`, surfaced as the `/green` command and the `green_meter` tool

  • Composer dock readout

    agentic session model calls in the dsh web composer→live `能耗 1.5 kJ · 碳 0.2 g` readout + per-turn energy sparkline

  • Detail panel (click the readout)

    click the readout→floating draggable drawer with per-turn energy chart, per-request energy list, session totals (tokens / energy / carbon / electricity cost) and carbon saved by caching ≈ N trees per year

  • `/green` session report

    one-command session energy report

  • `green_meter` tool

    the agent can query its own energy, carbon, cost and budget at any time

  • Energy budget

    optional per-session budget — over-budget steps are rejected with a warning

    over-budget steps are rejected with a warning
  • JSONL ledger

    every model call recorded, ready for your own analysis

04Who is it for? When not to use it?

Good for

  • DSH users and green-AI minded developers who want real-time visibility into what their agentic sessions cost
  • DSH users who want the agent itself to track its own energy use and enforce per-session limits

05Compatibility, maintenance and safety notes

  • Energy, carbon and cost figures are estimated from token accounting, not measured from hardware — the README says it works with any API-backed provider (DeepSeek API, OpenAI-compatible endpoints, local vLLM) without touching hardware.
  • Install targets the dsh `web` profile — the README's quick start runs inside `~/.dsh/profiles/web` and mounts the plugins in the profile's `cordis.patch.yml`.
  • Every model call is recorded to a JSONL ledger, ready for your own analysis.
2026-08-142026-08-17Not specified by the author

MIT · last push 2026-08-17, no releases

06Frequently asked questions

How do I install dsh-green-meter into DeepSeek Harness?

Run `pnpm add dsh-green-meter dsh-client-ui-green-meter` inside your dsh profile (`cd ~/.dsh/profiles/web`, Windows: `%USERPROFILE%\.dsh\profiles\web`), then mount both plugins in the profile's `cordis.patch.yml` and restart `dsh web`.

Does it measure real hardware power draw?

No — the README says values are estimated from token accounting, so it works with any API-backed provider (DeepSeek API, OpenAI-compatible endpoints, local vLLM) without touching hardware.

What can I see after install?

A live `能耗 1.5 kJ · 碳 0.2 g` readout under the composer with a per-turn energy sparkline; clicking it opens a draggable detail drawer with per-request energy, session totals and cache carbon savings. Type `/green` for a one-command session energy report.

Can the agent itself track energy?

Yes — the `green_meter` tool lets the agent query its own energy, carbon, cost and budget at any time, and an optional per-session energy budget rejects over-budget steps with a warning.

Where do the metrics go?

Every model call is recorded in a JSONL ledger, ready for your own analysis.

08Data and sources

  • Author-claimedgithub.comc0be78da28d4…

    A [dsh-plugin](https://github.com/topics/dsh-plugin) that turns every model call into **energy (J/kWh)**, **carbon footp…

  • Author-claimedgithub.comc0be78da28d4…

    # 1. Install into your dsh profile

  • Author-claimedgithub.comc0be78da28d4…

    Restart `dsh web`, refresh, and the readout appears under the composer. Type `/green` anytime.

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-28. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.