Commit Carbon

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

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.

Built by

Korext builds AI code governance tools.