Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.moneda.com/llms.txt

Use this file to discover all available pages before exploring further.

The Moneda CLI lets you interact with your Moneda account directly from the terminal. Check balances, browse transactions, send payments, and more — all without leaving the command line.

Installation

Install the CLI globally with npm:
npm install -g @moneda/cli
Verify the installation:
moneda --version

Quick start

Log in to your Moneda account:
moneda auth login
This opens your browser for OAuth authentication. Once approved, you’re ready to go. Check your balance:
moneda account balance
List recent transactions:
moneda transaction list --limit 5

Global flags

These flags work with any command:
FlagDescription
-o, --output <format>Output format: text (default), json, csv, markdown, or toon
--api-url <url>Override the API base URL (default: https://api.moneda.com/v1)
--api-key <key>Use an API key instead of OAuth (overrides the stored Bearer token)
-d, --detailReturn the full response shape (default is ?view=lite — compact output for terminal rendering)
-v, --verboseShow detailed request/response information
-q, --quietSuppress all output except errors
Use --output json to pipe CLI output into other tools like jq for scripting and automation. Use --output toon to see exactly what an LLM agent would consume from the same endpoint (~40% fewer tokens than JSON on array-heavy responses — handy when prototyping against @moneda/services’s agent tools).

Response shape: --detail flag

Every GET command defaults to ?view=lite — the REST API returns a compact shape optimised for terminal rendering (fewer columns, no UI coaching fields, no masked raw routing). Pass --detail when you need the full shape — typically when scripting with --output json and want every field the server exposes.
# Compact — one tidy row per transaction, no wrapping
moneda transaction list --limit 5

# Full — every field (typeGroup, category, note, reference, raw routing…)
moneda transaction list --limit 5 --detail --output json | jq
If a command’s output looks truncated, try --detail --output json to see everything.

What’s next?

CLI Authentication

Set up and manage your CLI credentials.

Command Reference

Browse all available CLI commands.

CLI Examples

Common workflows and scripting examples.

REST API

Use the REST API directly for deeper integrations.