Market evidence from the command line.

Install Leroy beside the agent or workflow you already use. Ask for a ticker and side; receive current context, historical matching, outcomes, and explicit limits.

$npm install -g @leroylabs/cli && leroy connect

No card required. Research only.
No broker connection or live trading.

From request to response.

Scroll through the five passes behind a CLI answer. Every step adds context before Leroy returns the evidence.

Inputs

The agent sends the setup it is considering. Leroy does not need a candle dump or a giant prompt.

Command

Leroy CLI

CLI
$ leroy ask buy ABNB

Assess Market

The current market frame adds context around the setup: volume, benchmarks, breadth, and volatility.

Volume

1.38× avg

Elevated

SPY

+0.42%

Firm

VTI

+0.31%

Firm

Breadth

61% advancing

Positive

Volatility

Normal

Neutral

Read Strategy Signals

Each supported strategy reports a signal so the agent can see agreement, disagreement, and neutral signals.

Opening Range 30

+0.82

Buy

Donchian 20

+0.67

Buy

Relative Strength

+0.41

Buy

VWAP

0.00

Neutral

RSI 14

+0.04

Neutral

Bollinger

−0.08

Neutral

Find Historical Matches

Leroy searches the verified record for comparable setups and measures what followed them.

AAPL · Buy · 15 minutes

184 comparable historical setups

Matched

Average Return

+3.84%

Win Rate

63%

Profit Factor

1.42

Return Evidence

The agent receives the evidence, assumptions, and boundary in one deterministic response.

Possible Return

Evaluated

AAPL · buy

15-minute historical average

+3.84%

Samples

184

Win Rate

63%

Profit Factor

1.42

Start with one question.

The default response is compact enough for a person to read and structured enough for an agent to pass along.

Want to try? This terminal is interactive!Give it a try below!

Commands

Two commands cover setup and research.

leroy connect

Validate the connection and save an API key locally with owner-only permissions.

leroy ask buy|sell|both SYMBOL

Evaluate a proposed side against current market context and the strongest available Market Memory tier.

leroy help

Print the local command summary and a link to this reference.

Flags

--setup

Include the current market setup, including benchmark, volume, session return, VWAP distance, and ATR when available.

--verbose

Include strategy detail and the Match Basis used to select the displayed evidence tier.

--json

Return the complete machine-readable response for agent and shell integrations.

--no-color

Disable terminal color codes for logs, pipes, and snapshots.

--horizon 5|15|30|60

Request one forward outcome horizon instead of the default set.

Match strength

Leroy selects the strongest available tier. It does not pool exact and comparable groups into one result.

5/5

Exact ticker setup

The same ticker, sensor state, ticker buckets, market buckets, and session-time identity.

4/5

Same setup on other tickers

The exact setup identity matched across other symbols.

3/5

Same registered-sensor state

The complete registered strategy/sensor state matched without an exact ticker match.

2/5

Same market context

The side, strategy context, and market-condition buckets matched.

1/5

Same side baseline

A directional baseline across the prepared archive.

Built for agents, readable by people.

Use the human-readable output in a terminal. Use JSON when another system needs to inspect status, match strength, outcomes, and provenance without parsing presentation text.

$ leroy ask buy ABNB --json
{
  "market_memory": {
    "matches": [{
      "match_strength": {
        "score": 5,
        "tier": "exact_ticker_setup"
      },
      "row_count": 50,
      "outcomes": { "15": {}, "30": {}, "60": {} }
    }]
  },
  "research_boundary": {
    "research_only": true,
    "live_order": false
  }
}

Study the system behind the answer.

The Research Center is where the evidence engine opens up: replay the strategies, compare the context, follow the model, and inspect the paper ledger.

Open Research Center