Metadata-Version: 2.5
Name: fxapi-cli
Version: 0.2.4
Summary: fxapi-py CLI — health check, API key login, BCP rates, interactive /help chat.
Project-URL: Homepage, https://fxapi-py.augustocerruttisatto.workers.dev
License: MIT
Keywords: bcp,cli,exchange-rates,fx,paraguay
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.12
Requires-Dist: httpx>=0.27
Requires-Dist: rich>=13
Requires-Dist: typer>=0.16
Description-Content-Type: text/markdown

# fxapi-cli

CLI for **fxapi-py** — Paraguay BCP exchange rates.

## Install

```bash
uv tool install fxapi-cli
```

## Quick start

```bash
# No key — is the API up?
fxapi

# Save your API key (from /register)
fxapi auth login

# Fetch a rate
fxapi rate USD
fxapi rate USD/EUR

# Interactive mode (slash commands)
fxapi chat
```

## Commands

| Command | Auth | Description |
|---------|------|-------------|
| `fxapi` | no | Health - LIVE / DOWN |
| `fxapi auth login` | — | Save API key to `~/.fxapi/config.toml` |
| `fxapi auth logout` | — | Clear saved key |
| `fxapi rate USD` | yes | BCP rate vs PYG |
| `fxapi rate USD/EUR` | yes | Cross rate via PYG |
| `fxapi rates` | yes | Table preview |
| `fxapi chat` | optional | REPL with `/help`, `/rate`, `/health` |

## Chat mode

```
fxapi> /help
fxapi> /health
fxapi> /login
fxapi> /rate USD
fxapi> /rate BRL/EUR
fxapi> /quit
```

Config: `~/.fxapi/config.toml` or env `FXAPI_KEY` + `FXAPI_BASE_URL`.
