Documentation

Docs version: v0.1.11 • GitHub Releases • CHANGELOG.md

Track rugby scores, fixtures, and results from your terminal. Works out of the box in free mode — no API key required.

Updated Feb 24, 2026 — navigation, grids, and code blocks now tune for better mobile and desktop responsiveness.

Getting Started

Install RugbyClaw and run the beginner flow in under 30 seconds:

npm install -g rugbyclaw
rugbyclaw start

Default leagues include Top 14, Premiership, URC, Champions Cup, and Six Nations.

Free mode includes a shared proxy with 50 requests/day. Add your own API key anytime for direct mode.

Core Commands

By default, human CLI output includes contextual Next steps after commands. Disable with --no-followups.

rugbyclaw scores

See today's matches across all your favorite leagues. Shows live scores, upcoming matches, and recent results.

rugbyclaw fixtures [league]

View upcoming matches. Optionally filter by league (e.g., rugbyclaw fixtures top14).

rugbyclaw results [league]

Recent match results with personality-driven summaries.

rugbyclaw standings [league]

View league tables with positions, records, points, and form.

rugbyclaw team search|next|last

Track specific teams. Get their next match or last result:

rugbyclaw team toulouse next
rugbyclaw team "stade toulousain" last

rugbyclaw doctor

Diagnose proxy/API/config issues with clear checks for onboarding and support.

rugbyclaw calendar <matchId>

Export matches to your calendar in ICS format.

rugbyclaw status

See current mode, timezone, and active leagues in one command.

News (AI-confirmed stories)

Rugby news confirmed by 3+ independent sources. No single-source rumors — only stories that multiple outlets are reporting.

rugbyclaw news

Confirmed stories from the last 24 hours (default). Synthesized by AI from BBC Sport, ESPN, The Guardian, Rugby World, and Ruck.

rugbyclaw news                # Today's confirmed stories
rugbyclaw news --since 4h     # Last 4 hours only
rugbyclaw news --json         # JSON for automation

Market Pulse (Polymarket probabilities)

Surface implied win probabilities for rugby fixtures via Polymarket. The command is read-only, informational-only, and confidence-gated (low-confidence projections stay hidden unless you opt in).

Lookup by match id

rugbyclaw market-pulse --match-id 12345

Lookup by teams, league, and date

rugbyclaw market-pulse --home toulouse --away "stade rochelais" --league top14 --date 2024-05-18

JSON and agent modes

rugbyclaw market-pulse --league premiership --date 2024-05-18 --json
rugbyclaw market-pulse --league premiership --date 2024-05-18 --agent

Note: Low-confidence output is hidden by default. Use --include-low-confidence to reveal gated probabilities when you need them.

rugbyclaw openclaw init

Get OpenClaw-ready setup guidance and automation-safe command mapping.

OpenClaw Integration

Use RugbyClaw with OpenClaw AI for natural language queries and automation:

rugbyclaw openclaw init --agent

Then ask naturally: "What's the score in the Toulouse game?" or "When does Toulouse play next?"

AI Agent Formats

Prefer machine-readable docs and contracts for automation:

Configuration

RugbyClaw works immediately after install using proxy mode (50 requests/day). For unlimited requests, add your own free API-Sports key:

rugbyclaw config

Supported Leagues

RugbyClaw currently supports 8 leagues:

  • Club: Top 14, Pro D2, Premiership Rugby, URC, Super Rugby Pacific
  • European: Champions Cup, Challenge Cup
  • International: Six Nations

Coming Soon Leagues

  • Women's Six Nations Coming Soon
  • Rugby Championship Coming Soon
  • Currie Cup Coming Soon
  • NPC Coming Soon
  • MLR Coming Soon
  • Rugby World Cup Coming Soon

See full league reference →

Need Help?