Troubleshooting

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

Common problems and solutions

Installation Issues

"command not found: rugbyclaw"

Problem: RugbyClaw not in PATH after npm install -g

Solution:

# Check npm global bin directory
npm config get prefix

# Add to PATH in ~/.bashrc or ~/.zshrc
export PATH="$PATH:$(npm config get prefix)/bin"

# Reload shell
source ~/.bashrc  # or ~/.zshrc

npm install fails

Problem: Permission errors during global install

Solution:

# Option 1: Use sudo (not recommended)
sudo npm install -g rugbyclaw

# Option 2: Fix npm permissions (recommended)
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH
npm install -g rugbyclaw

API Errors

"Rate limit exceeded"

Problem: Exceeded proxy mode limit (50 requests/day)

Solutions:

  • Wait until tomorrow (resets daily)
  • Add your own free API key: rugbyclaw config
  • Use --json + cache results locally

"API returned 404"

Problem: League or match not found

Solution:

  • Check league slug is correct: Supported Leagues
  • Verify match ID if using calendar export
  • Some leagues may be off-season

Connection timeout

Problem: Network issues or API down

Solution:

Team Commands

"No team found"

Problem: Team name not matching

Solutions:

  1. Try team search first: 
    rugbyclaw team search toulouse
  2. Use partial names:
    • ✅ toulouse (works)
    • ❌ Stade Toulousain Rugby Club (too specific)
  3. Check spelling
  4. Use team ID: 
    rugbyclaw team next 107

Wrong team showing up

Problem: Multiple teams match query

Solution:

  • Be more specific: "toulouse" → "stade toulousain"
  • Use team ID from search results
  • Put name in quotes if it has spaces

Display Issues

Colors not showing

Problem: Terminal doesn't support colors

Solution:

# Disable colors
rugbyclaw scores --no-color

Times in wrong timezone

Problem: Timezone not configured correctly

Solution:

rugbyclaw config
# Select correct timezone in wizard

Still Having Issues?

  1. Check recent changes:
  2. File a bug report:
    • Go to GitHub Issues
    • Include:
      • Command you ran
      • Error message
      • Your OS
      • RugbyClaw version (rugbyclaw --version)
  3. Check API-Sports status: