Skip to content

Korext/commit-carbon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Commit Carbon

The open standard for measuring AI assisted commit carbon emissions. CSRD, SEC, and CDP compatible disclosure reporting.

License: Code License: Methodology License: Data npm

Regulations now require companies to disclose emissions from digital operations. The EU Corporate Sustainability Reporting Directive (CSRD), California SB 253, and SEC Climate Rules all apply. AI coding tools are part of those operations. But nobody measures AI coding emissions at the code level.

Commit Carbon does.

Quick Start

# Get your AI attestation first
npx @korext/ai-attestation init

# Calculate carbon emissions
npx @korext/commit-carbon scan

Example Output

Commit Carbon v1.0.0

Repository: acme/payments-service
Period: All time
Grid region: US (avg 369 gCO2e/kWh)

AI Usage:
  Total commits: 1,247
  AI assisted: 438 (35.1%)
  Tools: GitHub Copilot, Cursor, Claude Code

Emissions Estimate:

  Low:     7.30 kg CO2e
  Central: 14.59 kg CO2e
  High:    29.18 kg CO2e

  Per AI commit average:
    33.3 g CO2e (central)

  For context:
    Equivalent to driving ~36 miles in an average car
    Equivalent to ~1,775 smartphone charges

What Makes This Different

  • First code level methodology: others measure aggregate AI emissions. We measure per commit.
  • Public methodology: CC0 licensed. No vendor lock in. Any tool can implement.
  • Regulatory alignment: CSRD, SEC, CDP, GHG Protocol Scope 3 compatible outputs.
  • Auditable: every number is sourced. Every calculation is reproducible.
  • Conservative bias: higher emission estimates by default. No greenwashing.
  • Ranged estimates: low/central/high. Reflects genuine uncertainty.

Disclosure Formats

# CSRD disclosure
npx @korext/commit-carbon report --format csrd

# SEC Climate Rules
npx @korext/commit-carbon report --format sec

# CDP response
npx @korext/commit-carbon report --format cdp

# GHG Protocol Scope 3
npx @korext/commit-carbon report --format ghg

Methodology

Published at oss.korext.com/commit-carbon/methodology.

See METHODOLOGY.md for the complete document.

Regulatory Frameworks

Framework Geography Compatibility
CSRD EU Direct disclosure format
SEC Climate Rules US Direct disclosure format
California SB 253 US (CA) Scope 3 compatible
CDP Global Direct format
GHG Protocol Global Scope 3 Category 1
SBTi Global Target setting compatible
ISO 14064 Global Methodology aligned

For Sustainability Teams

Free. Open. Auditable. See AUDIT_GUIDE.md for verification procedures.

Grid Data

Source Coverage Granularity API Key
IEA Global (country) Annual Not needed
EPA eGRID US (subnational) Annual Not needed
Electricity Maps Global (zone) Real-time Optional
WattTime Global Real-time Required

CI/CD Integration

- uses: korext/commit-carbon/action@v1
  with:
    region: US
    period: last_month
    max-emissions-kg: 50

Other Commands

# One-off calculation
npx @korext/commit-carbon calculate --tool copilot --commits 100 --region US

# View grid intensity
npx @korext/commit-carbon grid US
npx @korext/commit-carbon grid --list

# View emissions factors
npx @korext/commit-carbon factors

Relationship to Other Projects

Commit Carbon extends ai-attestation with carbon data. Can be used alongside ai-license, supply-chain-attestation, ai-incident-registry, ai-regression-database, and ai-code-radar.

Licensing

  • Code: Apache 2.0
  • Methodology and schema: CC0 1.0 (public domain)
  • Data: CC BY 4.0 (attribution required)

Contributing

See CONTRIBUTING.md. Particularly welcome: methodology improvements, grid data adapters, regional factor refinements, citation updates.

Feeds

Commit Carbon does not produce an RSS feed. Carbon reports are per-repository calculations, not an event stream. For aggregate carbon trends across open source, see AI Code Radar.

Built by

Korext builds AI code governance tools.

About

Carbon footprint of AI assisted commits. CSRD, SEC, CDP compatible. Peer reviewed methodology.

Topics

Resources

License

Apache-2.0 and 2 other licenses found

Licenses found

Apache-2.0
LICENSE
Unknown
LICENSE-DATA
CC0-1.0
LICENSE-SPEC

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors