edgefinder ask — AI-powered sports analysis command

Ask EdgeFinder an AI-powered sports question for NFL, NBA, or MLB. Get betting picks, player breakdowns, and matchup predictions from your terminal.

The ask command sends a natural-language question to EdgeFinder’s AI and returns a sports analysis response. By default it analyzes NFL, but you can switch to NBA or MLB with a single flag. Run edgefinder with no subcommand to enter an interactive REPL where you can ask follow-up questions without retyping the command.

Syntax

edgefinder ask <question> [--nfl] [--nba] [--mlb] [--json]

Options

query.question · string · required

Your sports analysis question in natural language. Wrap multi-word questions in quotes.

query.--nfl · boolean · default: "true"

Analyze using NFL context. This is the default league; you do not need to pass this flag explicitly.

query.--nba · boolean

Switch to NBA context. Overrides the default NFL league.

query.--mlb · boolean

Switch to MLB context. Overrides the default NFL league.

query.--json · boolean

Output the full JSON response instead of plain text. The JSON payload includes the AI’s response, full conversation history, token usage statistics, and rate limit information.

Examples

NFL (default)

edgefinder ask "Who should I bet on tonight?"

edgefinder ask --nba "Lakers vs Celtics prediction"

edgefinder ask --mlb "Yankees vs Red Sox prediction"

edgefinder ask --json "Best NFL picks this week"

Sample output

Analyzing (NFL)...
Based on current injury reports and recent form, I'd look at the Chiefs -3.5 against
the Raiders this week. Mahomes has a 74% cover rate at home over the last two seasons,
and the Raiders' secondary ranks 28th against the pass...

With --json:

{
  "response": "Based on current injury reports and recent form...",
  "conversationHistory": [
    { "role": "user", "content": "Best NFL picks this week" },
    { "role": "assistant", "content": "Based on current injury reports..." }
  ],
  "userId": "usr_abc123",
  "threadId": "thd_xyz789",
  "usage": {
    "tokensUsed": 412,
    "promptTokens": 88,
    "completionTokens": 324,
    "rateLimitRemaining": {
      "hour": 48,
      "minute": 9
    }
  }
}

League examples

NFL

edgefinder ask "Is Lamar Jackson a good bet for passing yards this week?"
edgefinder ask "Give me three player props for Sunday's games"
edgefinder ask "What's the injury situation for the 49ers?"

NBA

edgefinder ask --nba "Best player prop bets for tonight?"
edgefinder ask --nba "Is the over/under on Nuggets vs Thunder good value?"
edgefinder ask --nba "Which teams are on a back-to-back tonight?"

MLB

edgefinder ask --mlb "Best starting pitcher matchups this week"
edgefinder ask --mlb "Yankees vs Red Sox prediction"
edgefinder ask --mlb "Which teams have the best run line value today?"

Interactive mode

Run edgefinder with no subcommand to start an interactive REPL session. This lets you ask follow-up questions and refine your analysis without re-entering the full command each time.

edgefinder

Inside the REPL, use slash commands to switch the active league:

Command	Effect
/nfl	Switch to NFL analysis
/nba	Switch to NBA analysis
/mlb	Switch to MLB analysis

The interactive mode maintains conversation history across turns, so you can ask follow-up questions like “What about the over/under on that game?” and EdgeFinder will remember the context from your previous message.

If you pass both --nba and --mlb, --mlb takes precedence. If neither is passed, NFL is used.