⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
riseup
Query your RiseUp personal finance data — spending, income, balances, transactions, trends, and more. Activate when user mentions finances, spending, income, budget, bank balance, salary, subscriptions, debt, or riseup.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
// README
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
| Requirement | Version |
|---|---|
| Node.js | 22+ |
| Google Chrome | Latest |
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
riseupandriseup-cliwork 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.jsonwithchmod 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
| 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 |
YYYY-MM | riseup spending 2026-01 | Specific month |
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
- Download
riseup-skill.zipfrom the latest release - Go to Settings > Customize > Skills > "+" > Upload and select the ZIP
- 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, 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 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 groceri
// HOW IT'S BUILT
// FILES
2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.
src/data/SKILL.md10 KB2cbe3d440ae5upstream ↗
--- name: riseup description: Query your RiseUp personal finance data — spending, income, balances, transactions, trends, and more. Activate when user mentions finances, spending, income, budget, bank balance, salary, subscriptions, debt, or riseup. --- # RiseUp Finance CLI Skill Query your personal finance data from [RiseUp](https://input.riseup.co.il) (Israeli personal finance app) directly through Claude. ## Prerequisites 1. Install the CLI: `npm install -g riseup-cli` 2. Install Playwright browser: `npx playwright install chromium` 3. Authenticate: `riseup login` (opens Chrome for Google OAuth) 4. Verify: `riseup status` ## When This Skill Activates - User says "/riseup" or mentions the tool by name - User asks about personal finances, spending, income, budget - User asks "how much did I spend", "what's my balance", "show my salary" - User asks about subscriptions, bank accounts, credit card debt - User asks about financial trends or comparisons ## Autonomy Rules ### Run automatically (no confirmation needed) - `riseup spending [month]` and all flags - `riseup income [month]` and all flags - `riseup transactions [month]` and all flags - `riseup balance` - `riseup debt` - `riseup trends [months]` and all flags - `riseup progress` - `riseup plans` - `riseup insights` - `riseup account banks` - `riseup account subscription` - `riseup status` ### Require user confirmation - `riseup login` (opens browser) - `riseup logout` (clears session) ### ALWAYS ask user before running (write operations) These commands modify your RiseUp account data. Before running any of them: 1. Explain what the command will change and any side effects 2. Show the exact command to be executed 3. Wait for explicit user confirmation Write commands: - `riseup classify` — changes transaction category; with `--apply-to all` also teaches future auto-classification - `riseup rename` — changes transaction display name - `riseup comment` — adds a note to a transaction - `riseup exclude` — removes transaction from budget calculations - `riseup include` — adds excluded transaction back to budget - `riseup merge` — confirms credit card billing merge (irreversible) - `riseup set-budget-type` — marks transaction as fixed or variable expense - `riseup adjust` — changes predicted transaction amount For batch operations (e.g., classifying multiple unclassified transactions): - First run `riseup unclassified --json` to show what needs attention - Present all planned changes in a table - Ask user to confirm the batch before executing ## Quick Reference | Task | Command | |------|---------| | Current month spending by category | `riseup spending` | | Spending by merchant, top 10 | `riseup spending --by merchant --top 10` | | Spending by payment source | `riseup spending --by source` | | Filter spending to one category | `riseup spending --category "כלכלה"` | | Previous month spending | `riseup spending prev` | | Current month income | `riseup income` | | Salary only | `riseup income --salary-only` | | All transactions | `riseup transactions` | | Search transactions by merchant | `riseup transactions --search "carrefour"` | | Filter by category | `riseup transactions --category "רכב"` | | Expenses over ₪500 | `riseup transactions --expenses --min 500` | | Sort by amount | `riseup transactions --sort amount` | | Bank balance & investments | `riseup balance` | | Credit card debt | `riseup debt` | | 6-month trend | `riseup trends 6` | | Trend by category | `riseup trends --by category` | | Fixed vs variable expenses | `riseup trends --by breakdown` | | Financial health & savings | `riseup progress` | | Savings plans | `riseup plans` | | AI insights | `riseup insights` | | Connected banks & status | `riseup account banks` | | Subscription details | `riseup account subscription` | | Login status | `riseup status` | | List unclassified transactions | `riseup unclassified` | | Unclassified for specific month | `riseup unclassified 2026-02` | | Classify a transaction | `riseup classify <id> "מזון"` | | Classify + teach future matching | `riseup classify <id> "מזון" --apply-to all` | | Rename a transaction | `riseup rename <id> "Grocery Store"` | | Add a comment/note | `riseup comment <id> "monthly recurring"` | | Exclude from budget | `riseup exclude <id>` | | Re-include in budget | `riseup include <id>` | | Approve CC billing merge | `riseup merge <id>` | | Set as fixed expense | `riseup set-budget-type <id> fixed` | | Set as variable expense | `riseup set-budget-type <id> variable` | ## Output Modes - **Table (default)**: Human-readable tables with colors. Category names are in Hebrew. - **JSON (`--json`)**: Machine-readable. Use this when you need to analyze, aggregate, or filter data programmatically. Always use `--json` when you need to do custom analysis (e.g., finding subscriptions, grouping by patterns, calculating averages). ## Month Format Commands accepting a month argument support: - `current` — current budget month (default) - `prev` — previous month - `2026-02` — specific year-month Data is available for approximately 10 months back. ## Common Workflows ### "How much did I spend this month?" ```bash riseup spending ``` ### "What are my subscriptions?" ```bash riseup transactions --json ``` Then analyze the JSON output to find recurring merchants across months. ### "How much did I spend on groceries?" ```bash riseup spending --category "כלכלה" ``` ### "Am I saving money?" ```bash riseup trends 6 ``` Shows income vs expenses and net for each month. ### "What are my investments worth?" ```bash riseup balance ``` Shows bank balances plus investment portfolio (securities, savings accounts, loans, mortgages). ### "How am I doing financially?" ```bash riseup progress ``` Shows savings recommendations, positive months count, and spending trend analysis. ### "What are my fixed vs variable expenses?" ```bash riseup trends --by breakdown ``` Shows fixed and variable expenses per month over ~9 months. ### "Are all my bank connections working?" ```bash riseup account banks ``` Shows connection status, account numbers, and last sync time for each credential. ### "What's my biggest expense?" ```bash riseup transactions --expenses --sort amount --json ``` ### "How much gas/fuel did I spend?" ```bash riseup transactions --category "רכב" --json ``` Then filter for gas station merchants in the results. ### Multi-month analysis Fetch multiple months with `--json` and compare: ```bash riseup transactions 2026-01 --json riseup transactions 2026-02 --json riseup transactions current --json ``` ### "Classify all my unclassified transactions" ```bash riseup unclassified --json ``` Review the list, then for each transaction: ```bash riseup classify <transactionId> "מזון" riseup classify <transactionId> "רכב" --apply-to all ``` Use `--apply-to all` (default) to teach RiseUp to auto-classify future transactions from the same merchant. Use `--apply-to single` to classify only this transaction. Available categories (use Hebrew names): - כלכלה (Groceries), אוכל בחוץ (Eating Out), רכב (Car), מזון (Food) - קניות (Shopping), ביגוד והנעלה (Clothing), פארמה (Pharmacy), בריאות (Health) - דיגיטל (Digital), תקשורת (Telecom), תחבורה ציבורית (Public Transport), פנאי (Leisure) - ביטוח (Insurance), ארנונה (Property Tax), חשמל (Electricity), עמלות (Fees) - העברות (Transfers), תשלומים (Payments), שיק (Check), תרומה (Donations) - ביטוח לאומי (National Insurance), מס הכנסה (Income Tax), משכורת (Salary), קצבאות (Benefits) ### "Exclude duplicate/transfer transactions" ```bash riseup exclude <transactionId> ``` To undo: `riseup include <transactionId>` ### "Approve pending credit card merges" ```bash riseup merge <transactionId> ``` Merge types: `--input approved` (default), `loan`, `clearing`, `addCreds`, `bug` ## Hebrew Category Names Common categories and their English translations: - כלכלה = Groceries - אוכל בחוץ = Eating Out - רכב = Car/Vehicle - העברות = Transfers - קניות = Shopping - כללי = General - ביטוח = Insurance - ארנונה = Property Tax - שיק = Check - תרומה = Donations - ביגוד והנעלה = Clothing & Shoes - תשלומים = Payments - חשמל = Electricity - פארמה = Pharmacy - בריאות = Health - דיגיטל = Digital - תקשורת = Telecom - תחבורה ציבורית = Public Transport - פנאי = Leisure - עמלות = Fees - משכורת = Salary - קצבאות = Benefits/Allowances - מס הכנסה = Income Tax - ביטוח לאומי = National Insurance ## Error Handling | Error | Meaning | Action | |-------|---------|--------| | "No active session" | Not logged in | Run `riseup login` | | "Session expired" | Cookies expired | Run `riseup login` | | "No budget data found" | Month too far back | Try a more recent month | | Navigation timeout | Site slow/down | Retry `riseup login` | ## Budget Months vs Calendar Months RiseUp budget months may not align with calendar months — they depend on the user's cashflow start day setting. For example, the "March" budget month might cover Jan 30 – Feb 28, meaning actual March-dated transactions appear in the "April" budget month. When the user asks for a specific calendar month (e.g. "show me March transactions"): 1. Fetch with `--json` and check the actual date range of the returned transactions 2. If the dates don't match the requested calendar month, try the next budget month (e.g. `2026-04` for actual March dates) 3. Always tell the user the actual date range so they understand what they're looking at Example: User asks "show March spending" on March 10: ```bash # First try — may return Feb dates (budget month offset) riseup transactions 2026-03 --json # Check dates in output — if they're Feb dates, try next month riseup transactions 2026-04 --json ``` ## Known Limitations - Data goes back ~10 months (RiseUp API limitation) - Login requires a real Chrome browser (Google OAuth blocks automation) - Category names are in Hebrew (translate for English-speaking users) - Budget months may not align with calendar months (see section above)README.mdupstream ↗
Contents are not inlined in the catalog. Open the upstream file.
Plain-text copy, no login: /skill-bundles/arsolutioner-riseup-cli-src-data.md