marketintell

@marketintell/cli

Command-line interface for MarketIntell — talk to the Brain, stream answers, and watch alpha signals from your terminal.

npm install -g @marketintell/cli
mi auth login --key mi_k_yourkey
mi chat "Should I long or short BTC right now?"
mi signals --watch

Install

npm i -g @marketintell/cli       # or bun add -g @marketintell/cli / pnpm add -g

Requires Node 18+ (for native fetch).

Get an API key

Sign up at marketintell.ai and create a key in your dashboard. Keys look like mi_k_<48 hex chars>.

Quickstart

# 1. Save your key (verifies it before storing)
mi auth login --key mi_k_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 2. Confirm it's working
mi auth status

# 3. Ask the Brain
mi chat "What's BTC funding doing on the 1H?"

# 4. Stream a long answer
mi chat --stream "Give me a deep dive on ETH derivatives positioning"

# 5. Multi-turn conversation
mi chat -i

# 6. Watch alpha signals as they're generated
mi signals --watch

Commands

mi auth

Command	Purpose
mi auth login --key <KEY>	Save a key to ~/.config/marketintell/config.json (chmod 600)
mi auth login --key <KEY> --no-verify	Skip the round-trip verification
mi auth status	Show the key prefix, tier, scopes, and today's quota usage
mi auth logout	Delete the local config

mi auth login also accepts --api-url <url> for self-hosted / staging deployments.

mi chat

mi chat "<query>"                  # one-shot, prints content + footer
mi chat --stream "<query>"         # token-by-token via SSE
mi chat -i                         # interactive REPL
mi chat -s <session-id> "<query>"  # continue a previous session
mi chat --mode deep "<query>"      # force the T3 supervisor (Pro+)
mi chat --domain us_equities "..." # force a domain

REPL commands inside mi chat -i:

Input	Effect
:q / :quit	exit
:reset	start a new session (forgets context)
:session	print the current session_id
Ctrl-D	exit

mi signals

mi signals                         # top 10 signals as a table
mi signals --limit 25              # up to 100 (server-capped)
mi signals --watch                 # poll every 60s, print new signals as they arrive
mi signals --watch --interval 30000  # custom poll interval (ms, min 5000)

Global flags

Flag	Effect
-v, --version	Print the CLI version
-h, --help	Show help (works on subcommands too)
--json	Emit machine-readable JSON for piping to jq

Configuration

Config lives at ~/.config/marketintell/config.json. Two env vars override it (handy for CI):

Variable	Effect
MARKETINTELL_API_KEY	API key (overrides the file)
MARKETINTELL_API_URL	API base URL (default https://marketintell.fly.dev)
MARKETINTELL_CONFIG_DIR	Override the config directory (default ~/.config/marketintell)

Examples

# Pipe JSON output to jq
mi --json signals --limit 5 | jq '.signals[].headline'

# Use as a quick alpha tail in a tmux pane
mi signals --watch

# Use in CI / scripts without storing a key on disk
MARKETINTELL_API_KEY=$MI_KEY mi --json chat "BTC trend?" | jq -r '.content'

Roadmap

v0.1 surfaces only the endpoints that exist today. Coming in v0.2 once the API ships them:

• mi whales — large-trade tape
• mi options — flow scanner
• mi predict — prediction-market mispricings
• mi portfolio — portfolio context tools
• Persistent REPL history

License

Proprietary — see LICENSE at the repo root.