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.
- 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
| Requirement | Version |
|---|---|
| Node.js | 22+ |
| Google Chrome | Latest |
npm install -g riseup-cliOr install from GitHub:
npm install -g github:arsolutioner/riseup-cliThen install the browser dependency:
npx playwright install chromiumTip
Both riseup and riseup-cli work as commands.
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 sessionTip
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.
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 categoryriseup income # Current month income
riseup income --salary-only # Only salary entries
riseup income prev # Previous monthriseup 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 rangeriseup 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 predictionriseup balance # Bank balances + investment portfolio
riseup debt # Credit card debtriseup 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 expensesriseup progress # Financial health, savings recommendationsriseup plans # Savings goals and progress
riseup insights # AI-generated financial insights
riseup account banks # Connected banks, status & last sync
riseup account subscription # Subscription details| Flag | Description |
|---|---|
--json |
Output as JSON (for scripting and piping) |
--no-color |
Disable colored output |
Commands that accept a [month] argument support:
| Format | Example | Description |
|---|---|---|
current |
riseup spending current |
Current budget month (default) |
prev |
riseup spending prev |
Previous month |
YYYY-MM |
riseup spending 2026-01 |
Specific month |
riseup-cli ships with a skill so AI agents can query your finances directly using natural language.
riseup skill install # Install the skill- Download
riseup-skill.zipfrom the latest release - Go to Settings > Customize > Skills > "+" > Upload and select the ZIP
- Toggle the skill ON
Tell your OpenClaw agent:
Install the riseup skill from https://github.com/arsolutioner/riseup-cli/releases/latest — download
riseup-skill.zip, installriseup-clivia 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 outputAsk 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| 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 |
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