v0.5.6 Released

Sports AI in Your Terminal & Group Chat

A CLI and bot scaffold that connects any LLM to live sports data via sports-skills. Ask questions in plain English, get real answers from real data.

Copied!

$ curl -fsSL https://sportsclaw.gg/install.sh | bash

███████╗██████╗  ██████╗ ██████╗ ████████╗███████╗ ██████╗██╗      █████╗ ██╗    ██╗
██╔════╝██╔══██╗██╔═══██╗██╔══██╗╚══██╔══╝██╔════╝██╔════╝██║     ██╔══██╗██║    ██║
███████╗██████╔╝██║   ██║██████╔╝   ██║   ███████╗██║     ██║     ███████║██║ █╗ ██║
╚════██║██╔═══╝ ██║   ██║██╔══██╗   ██║   ╚════██║██║     ██║     ██╔══██║██║███╗██║
███████║██║     ╚██████╔╝██║  ██║   ██║   ███████║╚██████╗███████╗██║  ██║╚███╔███╔╝
╚══════╝╚═╝      ╚═════╝ ╚═╝  ╚═╝   ╚═╝   ╚══════╝ ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝

❯ sportsclaw "Who leads the Premier League and what are the NBA Polymarket odds?"

│

◒ Thinking

│

[sportsclaw] tool_call: football_get_competitions

[sportsclaw] tool_call: polymarket_search_markets

│

◐ Synthesizing...

│

◇ Done

Arsenal leads the Premier League with 61 points from 28 games (18W-7D-3L). They have a 5-point lead over second-place Manchester City.

On Polymarket, the Oklahoma City Thunder are the current favorites to win the 2026 NBA Finals at 34.5%, followed by the Spurs (12.6%) and Nuggets (11.5%).

How It Works

sportsclaw is a TypeScript CLI that connects LLMs to sports-skills, a Python package with 14 deterministic sports data connectors.

sports-skills

The deterministic data layer.

Zero API keys required
ESPN, FastF1, Polymarket
Normalizes complex JSON
Exposes JSON schemas to LLM

⇄

sportsclaw

The CLI & bot scaffold.

Anthropic, OpenAI, Google
Interactive setup & config
Persistent memory
Built-in Discord/Telegram bots

Readable Codebase

~2,300 lines of TypeScript built on the Vercel AI SDK. The core agent loop is ~80 lines. Easy to fork, extend, or learn from.

Zero API Keys for Data

You need an Anthropic or OpenAI key for the reasoning model, but the Python data layer requires absolutely zero API keys or paid subscriptions. It just works.

Interactive CLI

Setup is entirely interactive. Run it once, paste your API key, and watch the reasoning spinner solve your queries in real-time.

Discord & Telegram Bots

Want it in your group chat? The CLI includes built-in listeners.

sportsclaw listen discord
sportsclaw listen telegram