Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@claudinho/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@claudinho/cli ⚽

The 2026 men's football tournament, right in your terminal. Live scores, fixtures, and group tables — TZ-aware, localized, scriptable.

⚠️ Not affiliated with, endorsed by, or connected to FIFA or Anthropic. Claudinho is an independent, open-source fan project. It shows factual match data (scores, fixtures, standings) with emoji flags only — no logos, crests, kits, broadcast footage, or player likenesses.

Install

npm i -g @claudinho/cli      # installs the `claudinho` binary
# or run without installing:
npx @claudinho/cli today

Commands

claudinho today [date]      # a day's fixtures (default: today), live scores inline
claudinho live              # matches in play right now
claudinho next <TEAM>       # a team's next fixture + countdown   (e.g. next MEX)
claudinho table [GROUP]     # group standings (default: all groups)
claudinho match <id>        # a single match's detail
claudinho prompt            # one compact status line (for statusline/tmux/Starship)
claudinho init-statusline   # wire it into the Claude Code statusline
claudinho hook              # live-score context for a Claude Code hook (silent off-match)
claudinho init-hook         # make Claude itself score-aware (UserPromptSubmit)

Examples

claudinho today --tz America/Mexico_City --lang es
claudinho next BRA --tz America/Sao_Paulo --lang pt
claudinho table A
claudinho live --json | jq '.matches[].status'

Global options

Flag	Description
`--lang <code>`	`en`, `es`, `pt`, `fr` (also via `CLAUDINHO_LANG`; falls back to `$LANG`)
`--tz <zone>`	IANA timezone, e.g. `America/Mexico_City` (also `CLAUDINHO_TZ`; default: system)
`--json`	machine-readable output for scripting
`--no-color`	disable ANSI color (also honors `NO_COLOR`; auto-off when piped)
`--source <name>`	data source (default: `espn`)

Team codes are 3-letter (FIFA/IOC-style): MEX, BRA, USA, ENG, …

Statusline (Claude Code)

claudinho init-statusline          # patches ~/.claude/settings.json (backs up first)
claudinho init-statusline --print  # just print the snippet

The statusline reads from a local micro-cache and never blocks on the network (<150ms). When several matches are live it shows them all inline: ⚽ 🇪🇸 1–1 🇮🇶 87' · 🇫🇷 1–2 🇨🇮 86'. Customize via env:

CLAUDINHO_TEAM=MEX — show only your team's match
CLAUDINHO_MAX=2 — cap how many live matches show inline (rest collapse to +N; default: all)
CLAUDINHO_COMPACT=0 — show 3-letter codes alongside flags

Use the same claudinho prompt in tmux (set -g status-right '#(claudinho prompt)') or a Starship custom command — it works in any shell.

Score-aware Claude (hook)

claudinho init-hook                # patches ~/.claude/settings.json (backs up first)

Wires claudinho hook into Claude Code's UserPromptSubmit. During a match, the live score is injected into Claude's context so it can mention it naturally; off-match it's silent (zero added tokens). Restart Claude Code to activate.

Other competitions

By default Claudinho follows the 2026 World Cup. To follow a different ESPN competition (e.g. international friendlies before the tournament starts):

export CLAUDINHO_COMPETITION=fifa.friendly
claudinho live      # live friendlies
unset CLAUDINHO_COMPETITION   # back to the World Cup

Only the live fetch changes; the bundled schedule is always the World Cup.

How it works

The full fixture list (104 matches, groups, venues, kickoffs) ships bundled in the package, so the common path is offline and instant. Only live match state hits the network. Scores come from a swappable data adapter (ESPN by default); attribution and rate limits are respected.

@claudinho/cli