cricinfoCLI documentation

Super fast cricket analytics for agents

Every ball.
One command.

The vast, messy world of Cricinfo data—live matches, players, leagues, pitch maps, and derived analysis—shaped into a fast, self-describing Go CLI.

Install cricinfo↗View sourceGH
$npm i -g cricinfo-cli-go
LIVE
cricinfo matches live-view
IND287/446.2 OV
INDIA NEED 34 FROM 22 BALLS
V. KOHLI94 (81)
R. JADEJA31 (19)
14W062

› fetching scorecard, innings, partnerships

› traversed 7 endpoints in parallel

✓ rendered live view in 418ms

Ball-by-ball deliveries◆Live pitch maps◆Cursor pagination◆Goroutine parallelism◆JSON + JSONL◆Ball-by-ball deliveries◆Live pitch maps
01

THE COMMAND TREE

Ask cricket questions.
Not API questions.

Cricinfo’s internal API is fragmented across paginated endpoints. The CLI absorbs that complexity and gives you commands that match how you already think about the game.

01

cricinfo matches

Live scores, scorecards, deliveries

→02

cricinfo players

Profiles, careers, maps, match stats

→03

cricinfo teams

Rosters, leaders, records, scores

→04

cricinfo analysis

Batting, bowling, dismissals, partnerships

→

BUILT FOR THE SECOND READER

Readable by you.
Structured for agents.

Human-friendly text is the default. Add one flag and the same command becomes clean JSON or streaming JSONL for scripts, pipelines, and coding agents.

Explore output modes →
TEXTJSONJSONL
$ cricinfo analysis batting \
  --metric strike-rate \
  --scope season:2025 \
  --league 19138

1. Nicholas Pooran   177.34
2. Suryakumar Yadav  167.91
3. Travis Head       162.42

42 players · 126 innings · 0.61s
02

DOCUMENTATION

From first command
to deep analysis.

01Start

Quickstart

Install the npm package and run your first Cricinfo terminal queries.

↗02Commands

Command map

A high-level map of matches, players, teams, leagues, search, and analysis commands.

↗03Commands

Match workflows

Practical match commands for live, scorecard, innings, and delivery inspection.

↗04Commands

Players and teams

Player and team commands for entity lookup and match-scoped cricket data.

↗05Commands

Leagues, seasons, and search

Traversal workflows for finding the right competition context before deeper commands.

↗06Automation

Analysis and output modes

How to compose analysis scopes and choose the right output format for humans or agents.

↗07Operations

Development

Local development commands and repository architecture for contributors and agents.

↗08Operations

Release

How cricinfo versions become GitHub release binaries and the npm package.

↗

OPEN SOURCE · APACHE 2.0

Give your agent
a seat in the press box.

Install one binary. Ask better cricket questions.

Get started→