Agent & Automation

mytruv balances                  # TTY: table on stderr, stdout empty
mytruv balances --json           # JSON on stdout, even in a TTY
mytruv balances --output csv     # CSV on stdout
mytruv balances | cat            # piped: JSON on stdout (auto-detected)
mytruv balances > balances.json  # persist JSON to a file

{"error": "auth_required", "message": "Not authenticated. Run 'mytruv auth login' first."}

# Sum your checking balances
mytruv balances | jq '[.aggregated_balances[] | select(.type=="CHECKING") | (.balance | tonumber)] | add'

# Top 5 merchants over the last 30 days (only the field matching --group-by is populated)
mytruv spending --days 30 --group-by merchant \
  | jq '.spending.by_merchant[0:5] | map({merchant_name, total_amount, transaction_count})'

# Pull transactions in a date range and count by category
mytruv transactions --from 2026-01-01 --to 2026-04-01 \
  | jq '[.transactions[] | .categories[]] | group_by(.) | map({cat: .[0], n: length})'

# Net worth time series
mytruv balance-history --date-range 1y --time-period month | jq '.time_series'

# Guard a script on authentication
if ! mytruv auth status | jq -e '.authenticated' > /dev/null 2>&1; then
    echo "Please run: mytruv auth login" >&2
    exit 1
fi

gemini extensions install https://github.com/truvhq/mytruv-cli