# riseup

Adopt this skill: https://proskills.md/skills/other/arsolutioner-riseup-cli-src-data

Page: https://proskills.md/skills/other/arsolutioner-riseup-cli-src-data
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: src/data/SKILL.md
size: 10327
sha: 2cbe3d440ae5aaa23924d5f08c8e8c009125ef47
upstream: https://github.com/arsolutioner/riseup-cli/blob/main/src/data/SKILL.md

````text
---
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)
````

## File: README.md
upstream: https://github.com/arsolutioner/riseup-cli/blob/main/README.md

````text
<div align="center">

<img src="logo.png" alt="riseup-cli" width="200">

# riseup-cli

**Unofficial CLI and agentic skill for [RiseUp](https://www.riseup.co.il) 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.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![npm](https://img.shields.io/npm/v/riseup-cli?color=CB3837&logo=npm&logoColor=white)](https://www.npmjs.com/package/riseup-cli)
[![Node.js](https://img.shields.io/badge/Node.js-22%2B-339933?logo=node.js&logoColor=white)](https://nodejs.org)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.8-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org)
[![Playwright](https://img.shields.io/badge/Playwright-Auth-2EAD33?logo=playwright&logoColor=white)](https://playwright.dev)
[![Claude Code](https://img.shields.io/badge/Claude_Code-Skill-D97706?logo=anthropic&logoColor=white)](https://claude.com/claude-code)
[![LinkedIn](https://img.shields.io/badge/LinkedIn-Amram_Englander-0A66C2?logo=linkedin&logoColor=white)](https://www.linkedin.com/in/amram-englander)

<br>

[Installation](#installation) · [Commands](#commands) · [Claude Skill](#claude-code-and-claude-desktop-skill) · [Docs](https://arsolutioner.github.io/riseup-cli/) · [Contributing](#contributing)

</div>

---

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

```bash
npm install -g riseup-cli
```

Or install from GitHub:

```bash
npm install -g github:arsolutioner/riseup-cli
```

Then install the browser dependency:

```bash
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.

```bash
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

```bash
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

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

### Transactions

```bash
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

```bash
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

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

### Trends

```bash
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

```bash
riseup progress            # Financial health, savings recommendations
```

### More

```bash
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

```bash
riseup skill install       # Install the skill
```

### Claude Desktop / claude.ai

1. Download `riseup-skill.zip` from the [latest release](https://github.com/arsolutioner/riseup-cli/releases/latest)
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:

```bash
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
````
