riseup-cli

Unofficial CLI and agentic skill for RiseUp personal finance. Full programmatic access to your financial data — including features the web app buries — via the terminal and AI agents like Claude Code, Claude Desktop, Codex, and OpenClaw.

Installation · Commands · Claude Skill · Docs · Contributing

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.

[!WARNING] Unofficial Library – Use at Your Own Risk

This tool uses undocumented RiseUp APIs that can change without notice.

• Not affiliated with RiseUp – This is a community project
• APIs may break – RiseUp can change internal endpoints anytime
• Your data stays local – 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
• Transaction management — classify, rename, comment, exclude, merge
• Bank balances & investments — balances, securities portfolio, savings, loans
• Credit card debt — debt per card at a glance
• Trends — month-over-month income vs. expenses, fixed vs. variable breakdown
• Financial progress — savings recommendations and spending trend analysis
• Claude Code skill — ask Claude about your finances in natural language
• JSON output — pipe to jq, scripts, or any tool

Requirements

Installation

npm install -g riseup-cli

Or install from GitHub:

npm install -g github:arsolutioner/riseup-cli

Then install the browser dependency:

npx playwright install chromium

[!TIP] Both riseup and riseup-cli work as commands.

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

Transaction Management

riseup unclassified                          # List unclassified transactions
riseup classify <id> "מזון"                  # Classify a transaction
riseup classify <id> "מזון" --apply-to all   # Classify + teach future matching
riseup rename <id> "Grocery Store"           # Rename display name
riseup comment <id> "monthly recurring"      # Add a note
riseup exclude <id>                          # Exclude from budget
riseup include <id>                          # Re-include in budget
riseup merge <id>                            # Approve CC billing merge
riseup set-budget-type <id> fixed            # Set as fixed expense
riseup adjust <envId> 500 --sequence-id <seqId>  # Adjust prediction

Balances

riseup balance    # Bank balances + investment portfolio
riseup debt       # Credit card debt

Trends

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
riseup trends --by breakdown  # Fixed vs variable expenses

Progress

riseup progress            # Financial health, savings recommendations

More

riseup plans                  # Savings goals and progress
riseup insights               # AI-generated financial insights
riseup account banks          # Connected banks, status & last sync
riseup account subscription   # Subscription details

Global Options

Month Format

Commands that accept a [month] argument support:

AI Agent Skills

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

Claude Code

riseup skill install       # Install the skill

Claude Desktop / claude.ai

1. Download riseup-skill.zip from the latest release
2. Go to Settings > Customize > Skills > "+" > Upload and select the ZIP
3. Toggle the skill ON

OpenClaw

Tell your OpenClaw agent:

Install the riseup skill from https://github.com/arsolutioner/riseup-cli/releases/latest — download riseup-skill.zip, install riseup-cli via npm, and set it up. Here is my session file: <paste contents of ~/.config/riseup-cli/session.json>

To get your session, login locally first:

npm install -g riseup-cli
npx playwright install chromium
riseup login
cat ~/.config/riseup-cli/session.json   # Copy this output

Try it

Ask your agent:

• "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

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

License

MIT