JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 18
  • Score
    100M100P100Q48694F
  • License MIT

Unofficial CLI for RiseUp personal finance, query your spending, income and balances from the terminal

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 (riseup-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    riseup-cli

    riseup-cli

    Unofficial CLI for RiseUp personal finance

    Query your spending, income, balances, and more — straight from the terminal.

    License: MIT Node.js TypeScript Playwright Claude Code


    Installation · Commands · Claude Code Skill · Contributing

    [!NOTE] RiseUp is an Israeli personal finance app with no public API. This CLI was built by reverse-engineering the internal API that powers the RiseUp web app, so you can access your own financial data programmatically — from the terminal or through AI agents like Claude Code. All requests go directly from your machine to RiseUp's servers using your own session cookies. Nothing is proxied, stored, or sent anywhere else.

    Features

    • Spending breakdown — by category, merchant, or payment source
    • Income tracking — salary, benefits, and all income sources
    • Transaction search — filter by merchant, category, amount, type
    • Bank balances — current balance across all connected accounts
    • Credit card debt — debt per card at a glance
    • Trends — month-over-month income vs. expenses comparison
    • Claude Code skill — ask Claude about your finances in natural language
    • JSON output — pipe to jq, scripts, or any tool

    Requirements

    Requirement Version
    Node.js 22+
    Google Chrome Latest

    Installation

    npm install -g github:arsolutioner/riseup-cli

    Then install the browser dependency:

    npx playwright install chromium

    Authentication

    RiseUp uses Google OAuth. The CLI opens a real Chrome window so you can sign in manually — no passwords are stored or transmitted by this tool.

    riseup login     # Opens Chrome, sign in, session saved
riseup status    # Check login status and account info
riseup logout    # Clear session

    [!TIP] Sessions are stored at ~/.config/riseup-cli/session.json with chmod 0600. The browser uses a persistent profile with automation detection disabled so Google OAuth works normally.

    Commands

    Spending

    riseup spending                          # Current month by category
riseup spending prev                     # Previous month
riseup spending --by merchant --top 10   # Top 10 merchants
riseup spending --by source              # By payment source (bank/card)
riseup spending --category "כלכלה"       # Filter one category

    Income

    riseup income                   # Current month income
riseup income --salary-only     # Only salary entries
riseup income prev              # Previous month

    Transactions

    riseup transactions                          # List all this month
riseup transactions --search "carrefour"     # Search by merchant
riseup transactions --category "רכב"         # Filter by category
riseup transactions --expenses --sort amount # Expenses sorted by amount
riseup transactions --min 500 --max 2000     # Amount range

    Balances

    riseup balance    # Bank account balances
riseup debt       # Credit card debt
    riseup trends              # 3-month comparison (income vs expenses vs net)
riseup trends 6            # 6-month comparison
riseup trends --by category # Breakdown by category over time

    More

    riseup plans                  # Savings goals and progress
riseup insights               # AI-generated financial insights
riseup account banks          # Connected banks and cards
riseup account subscription   # Subscription details

    Global Options

    Flag Description
    --json Output as JSON (for scripting and piping)
    --no-color Disable colored output

    Month Format

    Commands that accept a [month] argument support:

    Format Example Description
    current riseup spending current Current budget month (default)
    prev riseup spending prev Previous month
    -N riseup spending -2 N months back
    YYYY-MM riseup spending 2026-01 Specific month

    Claude Code Skill

    riseup-cli ships with a Claude Code skill so Claude can query your finances directly using natural language.

    riseup skill install       # Install the skill

    Then just ask Claude:

    • "How much did I spend this month?"
    • "What are my subscriptions?"
    • "Show my salary for the last 3 months"
    • "Am I saving money?"
    • "How much did I spend on groceries?"
    riseup skill status        # Check if installed
riseup skill uninstall     # Remove the skill
riseup skill show          # Display skill content

    Tech Stack

    Component Technology
    Runtime Node.js 22+ (native fetch, ESM)
    Language TypeScript
    CLI Framework Commander.js
    Output Chalk + cli-table3
    Auth Playwright (headed Chrome)
    Build tsup

    Contributing

    Contributions are welcome! This project is built with TypeScript and uses tsup for building.

    git clone https://github.com/arsolutioner/riseup-cli.git
cd riseup-cli
npm install
npm run build
npm run dev -- spending    # Run in dev mode

    Disclaimer

    [!WARNING] This is an unofficial tool and is not affiliated with or endorsed by RiseUp. Use at your own risk. The internal API may change at any time.

    License

    MIT