Moneda CLI

Command-line interface for interacting with your Moneda account.

Installation

npm install -g @moneda/cli

Or with pnpm:

pnpm add -g @moneda/cli

For one-off usage without a global install:

pnpm dlx --package=@moneda/cli moneda --help

Or with npm:

npm exec --package=@moneda/cli -- moneda --help

Or run directly from the monorepo:

pnpm --filter @moneda/cli dev

Published installs ship a bundled executable from dist/ instead of the full source tree. Published binaries default to https://rest.moneda.com for data requests and https://id.moneda.com for OAuth. The local dev script switches those defaults to http://localhost:3000 and http://localhost:3939.

Local development

Use a single workspace install, then build and link only the CLI package:

# From the repo root
pnpm install --frozen-lockfile

# Build only the CLI package
pnpm --filter @moneda/cli build

# Link the local moneda binary globally
pnpm --dir packages/cli link:local

The local link exposes both moneda and the short alias mnda.

For faster iteration during CLI development:

pnpm --filter @moneda/cli build:dev

This path avoids unrelated workspace builds. If pnpm install wants to repair the lockfile, stop and fix pnpm-lock.yaml first instead of letting local CLI work mutate the workspace dependency graph.

The local development workflow still runs from source, but published packages are dist-first and intentionally minimal. You can override either environment explicitly with MONEDA_API_URL, MONEDA_AUTH_URL, or --api-url / --auth-url.

Quick start

# 1. Create an account (if you don't have one)
moneda auth signup

# 2. Log in via browser
moneda auth login

# 3. Check your balance
moneda account balance

# 4. Send a payment
moneda payment send --to alice --amount 10.00 --currency USD

Authentication

The CLI supports two authentication methods:

OAuth (browser login)

moneda auth login      # Opens browser for OAuth flow
moneda auth status     # Check current auth status
moneda auth logout     # Clear stored credentials

Tokens are stored in ~/.moneda/auth.json with restricted permissions (0600).

API key

Pass an API key via flag or config:

# Via flag (per-command)
moneda account balance --api-key sk_live_...

# Via config (persistent)
moneda config set api_key sk_live_...

API keys can be created in the Moneda mobile app.

Commands

moneda auth — Authentication and account management

| Command | Description | | -------- | ----------------------------------------------------- | | signup | Display QR code to download the app and create account | | login | Authenticate via browser OAuth flow | | logout | Clear stored credentials | | status | Show current authentication status |

moneda account — Account information

| Command | Description | | ----------------- | ------------------------------ | | balance | Show account balances | | wallet | Show smart wallet address | | settings | Show account settings | | virtual-accounts| List virtual accounts |

moneda transaction — Transaction management

| Command | Description | | ------------ | ------------------------------------- | | list | List transactions (with filters) | | categorize | Set category on a transaction | | note | Add a note to a transaction | | export | Export transactions to CSV/JSON |

moneda payment — Payments

| Command | Description | | -------- | --------------------------------- | | send | Initiate a payment | | status | Check payment request status |

moneda contact — Contact management

| Command | Description | | -------- | ------------------------------ | | list | List saved contacts | | add | Add a new contact | | search | Search for Moneda users |

moneda bank — Bank accounts

| Command | Description | | ------- | ---------------------- | | list | List linked bank accounts | | add | Link a new bank account |

moneda wallet — External wallets

| Command | Description | | ------- | ------------------------ | | list | List linked wallets | | add | Link an external wallet |

moneda points — Rewards

| Command | Description | | ---------- | ------------------------ | | balance | Show points balance | | activity | List points activity |

moneda referral — Referrals

| Command | Description | | ------- | -------------------------- | | code | Show your referral code | | list | List referred users |

moneda knowledge — Help & FAQ

| Command | Description | | -------- | -------------------------- | | search | Search the knowledge base |

moneda config — CLI configuration

| Command | Description | | ------- | ---------------------------- | | set | Set a configuration value | | get | Get a configuration value | | list | List all configuration |

moneda api — Raw API calls

# GET request
moneda api GET /v1/balances

# POST with JSON body
moneda api POST /v1/payments -d '{"amount":"10","currency":"USD",...}'

moneda update — Self-update

moneda update          # Check for updates and install
moneda upgrade         # Alias for update
moneda update --check  # Check only, don't install

Global options

| Flag | Description | | -------------------- | ---------------------------------------------- | | -o, --output <fmt> | Output format: text, json, csv, markdown | | --api-url <url> | Override API base URL | | --api-key <key> | Use API key authentication | | -v, --verbose | Verbose output | | -q, --quiet | Suppress non-essential output | | -h, --help | Show help for any command | | -V, --version | Show CLI version |

Configuration

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

moneda config set api_url https://rest.moneda.com
moneda config set api_key sk_live_...
moneda config list