mindvest-atlas 0.2.0

Atlas CLI — OAuth login, tool calls, and live alert/flow streaming for the Atlas trading API

Atlas CLI (Python)

The Python implementation of the Atlas CLI. Zero third-party dependencies — pure standard library, Python ≥ 3.8.

Install

pipx install mindvest-atlas      # recommended (isolated)
# or
pip install --user mindvest-atlas
atlas login

Or run from a clone without installing:

cd python
python -m atlas_cli --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

atlas_cli/
  cli.py              # arg parsing + command dispatch + entry point (`run`)
  config.py           # constants, endpoints, paths
  pkce.py oauth.py loopback.py store.py   # auth: PKCE, OAuth, callback server, 0600 store
  client.py catalog.py stream.py _http.py # API client (+ auto-refresh), catalog, SSE
  ui.py args.py help.py format.py stream_loop.py
  commands/           # login, logout, whoami, tools, call, alerts, flow
tests/                # unittest suites (offline)

Test

python -m unittest discover -s tests

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.