Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@eterna-hybrid-exchange/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

eterna

CLI for Eterna Exchange — execute AI trading strategies from your terminal.

Install

npx @eterna-hybrid-exchange/cli --help

Or install globally:

npm install -g @eterna-hybrid-exchange/cli

Quick Start

# Authenticate (opens browser or shows device code for SSH)
npx @eterna-hybrid-exchange/cli login

# Execute a strategy file
npx @eterna-hybrid-exchange/cli execute strategy.ts

# Pipe code via stdin
echo 'const balance = await eterna.getBalance(); return balance;' | npx @eterna-hybrid-exchange/cli execute -

# Check balance and positions
npx @eterna-hybrid-exchange/cli balance
npx @eterna-hybrid-exchange/cli positions

# Browse the SDK
npx @eterna-hybrid-exchange/cli sdk --search "place order"
npx @eterna-hybrid-exchange/cli sdk --detail full

Commands

Command	Description
`eterna login`	Authenticate with Eterna (browser or device code)
`eterna logout`	Remove stored credentials
`eterna execute <file>`	Execute TypeScript in the Eterna sandbox
`eterna sdk`	Browse SDK method reference
`eterna balance`	Get account balance (shortcut)
`eterna positions`	Get open positions (shortcut)

Authentication

The CLI supports two authentication flows, auto-detected based on your environment:

Browser flow: Opens your default browser for Google OAuth (used when running locally)
Device code flow: Shows a URL and code to enter in any browser (used over SSH or with --no-browser)

Credentials are stored in ~/.eterna/credentials.json and auto-refreshed when expired.

Configuration

Config is stored in ~/.eterna/config.json:

{
  "endpoint": "https://ai-api.eterna.exchange"
}

Override the config directory with the ETERNA_CONFIG_DIR environment variable.

Environment Variables

Variable	Description	Default
`ETERNA_ENDPOINT`	API endpoint URL	`https://ai-api.eterna.exchange`
`ETERNA_AUTH_ISSUER`	OAuth authorization server URL	`https://ai-auth.eterna.exchange`
`ETERNA_MCP_URL`	MCP gateway URL	`https://mcp.eterna.exchange`
`ETERNA_CONFIG_DIR`	Config/credentials directory	`~/.eterna`
`ETERNA_MCP_KEY`	Legacy mcp-gateway API key — if set, `eterna login` links it to your OAuth identity automatically, preserving your existing Bybit subaccount	(none)

License

MIT