Chapter 05CLI & Human-Machine Homogeneous

MeetCarbon Shell — CLI and human-machine homology

mc covers auth, energy, carbon accounting, charging, and other live domains. The same capabilities are available from the CLI.

Human-machine homology

One capability definition, shared by GUI / CLI / AI — invest once, get three channels

GUI

CLI

AI assistant

Capabilities are identical — GUI actions can be scripted in CLI and invoked in natural language by AI

CLI in action

The mc CLI — manage energy-carbon work the way you use kubectl

meetcarbon-cli — bash

$ mc auth login

Signed in. Token saved for later commands.

$ mc energy carbon-overview

Carbon overview returned for the current organization.

$ mc charging stations list

Station list returned.

$ mc carbon projects

Carbon accounting projects returned.

12 CLI domains

Auth, energy, carbon, charging, contracts, projects, enterprise, tickets, finance, inclusive carbon, policy, and calc

Auth & accounts

mc auth login

Login and token management

Energy

mc energy carbon-overview

Carbon overview and energy trends

Carbon accounting

mc carbon projects

Emissions data and device collection

Charging operations

mc charging stations list

Station stats and order analysis

Contracts

mc contract list

Contract stats and alerts

Projects

mc project list

Pipeline, kickoff, milestones

Enterprise

mc enterprise oa

OA collaboration

Work orders

mc workorder list

List and create tickets

Finance

mc finance funds-stats

Funds statistics

Inclusive carbon

mc carbon-benefit overview

Overview statistics

Policy search

mc policy search

Energy-carbon policy search

Calculator

mc calculator emit

Emission estimates

Iceberg architecture

Users see a concise mc command; a full engineering stack sits below the waterline

Above the waterline

mc [domain] [action]
~~ waterline ~~
Auth · token management · multi-tenant
HTTP/gRPC client · API routing · middleware
Request serialization · response parsing · error handling
Formatted output · table/JSON/CSV · color terminal
Config · environment variables · multi-profile
Plugin system · custom commands · extension points
Offline cache · incremental sync · local storage
Logs · telemetry · performance tracing

Below the waterline