Metadata-Version: 2.4
Name: mindvest-atlas
Version: 0.1.0
Summary: Atlas CLI — OAuth login, tool calls, and live alert/flow streaming for the Atlas trading API
Project-URL: Homepage, https://github.com/finmanagerai/atlas-cli
Project-URL: Repository, https://github.com/finmanagerai/atlas-cli
Project-URL: Issues, https://github.com/finmanagerai/atlas-cli/issues
Author: FinManagerAI
License: MIT
License-File: LICENSE
Keywords: atlas,cli,mcp,mindvest,oauth,options,trading
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# Atlas CLI (Python)

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

## Install

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

Or run from a clone without installing:

```sh
cd python
python -m atlas_cli --help
```

## Usage

See the [top-level README](../README.md) for the full command reference. Quick
tour:

```sh
atlas login
atlas tools
atlas stock-quote --symbol SPY
atlas options-chain --symbol SPY --expiration 2026-06-20
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

```sh
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.
