Atlas CLI (Node.js)

The Node.js implementation of the Atlas CLI. Zero runtime dependencies — just Node ≥ 18 (uses the built-in fetch, Web Streams, crypto, and http).

Install

npm install -g mindvest-atlas   # installs the `atlas` command
atlas login

Or run from a clone without installing:

cd node
node bin/atlas.js --help

Usage

See the top-level README for the full command reference. Quick tour:

atlas login
atlas tools
atlas stock-quote --symbol SPY
atlas options-chain --symbol SPY --expiration 2026-06-20
atlas historical-contract --symbol NVDA --expiry 2026-07-13 --strike 205 --side call --from 2026-07-06 --to 2026-07-10
atlas alerts --symbol SPY --name greek_exposure --save-charts ./charts
atlas flow stream --symbol NVDA

Layout

bin/atlas.js          # executable entry point
src/
  cli.js              # arg parsing + command dispatch
  config.js           # constants, endpoints, paths
  auth/               # pkce, oauth, loopback callback server, 0600 token store
  api/                # authenticated client (+ auto-refresh), catalog, SSE parser
  commands/           # login, logout, whoami, tools, call, alerts, flow
  util/               # args, help, formatting, terminal UI, stream loop
test/                 # node --test suites (offline)

Test

npm test

Runs PKCE/arg/SSE/storage unit tests plus integration tests that drive the real OAuth client and loopback server against in-process mock servers — no network required.