drillr-cli

Drillr financial research CLI — powered by AI.

Quick stock lookups, deep multi-source research, and earnings analysis — all from your terminal.

Install

npm install -g drillr-cli

Quick Start

# Option A: Use API key (get one from your Drillr admin)
drillr auth set-key dgr_live_xxx

# Option B: Login via browser (OAuth)
drillr auth login

# Ask a quick question
drillr ask "What is Apple's current PE ratio?"

# Run deep research
drillr research "Compare NVDA and AMD revenue growth over the last 3 quarters"

Commands

Authentication

drillr auth login              # Login via browser (OAuth)
drillr auth login --gateway <url>  # Use custom gateway URL
drillr auth set-key <key>      # Set API key directly
drillr auth set-key <key> --gateway <url>
drillr auth status             # Show current auth status
drillr auth logout             # Clear stored credentials

Research

# Quick Q&A (5-15 seconds)
drillr ask "TSLA stock price today?"
drillr ask "What is Microsoft's dividend yield?"

# Deep research (may take several minutes)
drillr research "Analyze NVDA's competitive position in the AI chip market"
drillr research "Compare earnings trends for FAANG stocks"

# Continue a conversation
drillr ask -s <session_id> "What about their margins?"

# Add context
drillr ask -c "Focus on data center segment" "How is AMD performing?"

Options

| Option | Short | Description | | ------------------ | ----- | ----------------------------------- | | --session <id> | -s | Continue a previous session | | --context <text> | -c | Additional context for the question | | --gateway <url> | | Custom gateway URL (auth commands) |

Output

• Research text streams to stdout in real-time
• Tool calls and metadata print to stderr (in gray)
• Pipe-friendly: drillr ask "AAPL price" > result.txt

Authentication

Credentials are stored at ~/.config/drillr/credentials.json (file permissions 600).

Two auth methods:

• API Key: Static key, simple setup. Get one from your Drillr admin.
• OAuth: Browser-based login via Google account. Tokens auto-refresh.

Rate Limits

| Limit | Value | | ------------------- | ---------- | | Requests | 30/minute | | Concurrent research | 2 max | | Research timeout | 15 minutes |