Quick Start

Install the CLI

npm install -g @ocpp-debugkit/cli

Inspect a trace

Parse and analyze an OCPP 1.6 JSON trace file:

ocpp-debugkit inspect trace.json

This outputs a summary with event count, sessions, and detected failures.

Generate a report

Generate a Markdown report from a trace:

ocpp-debugkit report trace.json --output report.md

Run a scenario

Run a predefined scenario through the analysis engine:

# List available scenarios
ocpp-debugkit scenario list

# Run a scenario
ocpp-debugkit scenario run failed-auth

Use the web inspector

No installation required — visit the inspector and paste a trace, upload a file, or select a sample scenario.

Use the core library

For programmatic use in your own TypeScript/JavaScript project:

import { parseTrace, buildSessionTimeline, detectFailures } from '@ocpp-debugkit/core';

const result = parseTrace(traceString);
const sessions = buildSessionTimeline(result.events);
const failures = detectFailures(result.events, sessions);

console.log(`Found ${failures.length} failures`);