Aether Wealth CLI

A deterministic terminal for journal review, stats, exports, and automation hooks — no dashboard required.

The shell interface for repeatable trading workflows — tasks you want scripted, audited, or piped into another system. Use the MCP server when an assistant should decide which tool to call.

Get it on npm Back to builder overview

Install CLI

npm i -g @aetherwealth/cli

~/aether-wealthlive

$ aether-wealth trades list --status OPEN

  PAIR      DIR    ENTRY      P&L
  ─────────────────────────────────
  EUR/USD   LONG   1.0852    +$142
  XAU/USD   SHORT  2647.10   -$ 32
  BTC/USDT  LONG   68420     +$384

  3 open · +$494.60

CLI status

The CLI is live on npm as @aetherwealth/cli. Install it with npm i -g @aetherwealth/cli, then run aether-wealth login to sign in over OAuth — every command hits the same backend as the MCP.

Quickstart

From install to your journal in a few commands.

Sign in once — per-user browser OAuth, no shared API key. The token is stored in your OS keychain (with a protected 0600 file fallback). For CI, set AETHER_ACCESS_TOKEN to a pre-minted token and skip the browser entirely.

quickstart.shbash

# install
npm i -g @aetherwealth/cli

# sign in (opens your browser once)
aether-wealth login

# use it
aether-wealth trades list --status OPEN
aether-wealth stats --pair EURUSD
aether-wealth indicators rsi macd --pair EURUSD --timeframe 1h
aether-wealth market calendar --min-impact 4

# scripting: JSON out, distinct exit codes (4 = rate-limited)
aether-wealth trades list --json | jq '.trades[]'

Command groups

Commands for repeatable trading operations.

$aether-wealth auth

browser sign-in · status · logout

$aether-wealth trades

list · show · create · update · close · delete

$aether-wealth accounts

list · create · update · delete · per-account history

$aether-wealth stats

win rate · profit factor · period summaries

$aether-wealth alerts

price · trendline · indicator alerts

$aether-wealth market

candles · calendar · macro · instruments

$aether-wealth indicators

RSI · MACD · EMA and more, on any pair

$aether-wealth chat

ask Aether Intelligence from the terminal

$aether-wealth keys

manage API keys for non-MCP automation

Global flags

These apply to every command.

--jsonMachine-readable JSON instead of tables — errors included.

--no-colorDisable ANSI color for logs and pipes.

--debugPrint request method, status, and timing to stderr.

--yes, -ySkip the delete confirmation (required in non-interactive shells).

Environment

Point the CLI at a backend, run headless, or set per-command defaults.

AETHER_BASE_URL

Backend URL. Defaults to https://api.aetherwealth.ai; https unless a loopback host.

AETHER_ACCESS_TOKEN

Pre-minted OAuth token for CI — skips the browser, read fresh per request, never written to disk.

AETHER_CLI_CREDENTIALS_FILE

Force the 0600 file credential store instead of the OS keychain.

AETHER_DEFAULT_ACCOUNT_ID

Default --account when omitted on trade commands.

AETHER_DEFAULT_CONVERSATION_ID

Default --conversation when omitted on chat commands.

Journaling, not order routing

trades create and trades close record entries in your Aether Wealth journal for analysis and stats — they never place, modify, or close live orders with any broker. Every request runs as you over HTTPS with your account permissions; backend rate limits apply, and over-limit reads exit with code 4 so a script can back off and retry.

CLI or MCP?

Use MCP when Claude, Codex, Cursor, or another assistant should inspect context and choose tools. Use the CLI when you want a predictable command in a shell script, cron job, or export workflow.