zenmoney-go

Установка

go install github.com/miilg/zenmoney-go/cmd/zm@latest

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

CLI zm синхронизирует данные ZenMoney и показывает счета с балансами, транзакции с фильтрами по датам, счетам и категориям, дерево категорий и помесячную сводку доходов и расходов. Скилл zenmoney разрешает Claude запускать только команды zm, сам считает суммы и сравнивает периоды. Go-библиотека дает доступ к синхронизации, отправке изменений, подсказке категорий и OAuth2.

Для кого. Для пользователей ZenMoney, которые хотят спрашивать агента о своих расходах и доходах обычным языком.

Пример запроса к агенту

Сколько я потратил на кафе и рестораны в марте?

Ограничения

Нужны установленный Go для сборки, токен ZenMoney и zm в PATH. CLI в README описан для чтения данных, запись доступна только через библиотеку. Данные в ZenMoney попадают из банковских SMS и push-уведомлений на телефоне.

Как отключить. Удалите ~/.claude/skills/zenmoney. Сохраненный токен и данные лежат в ~/.config/zenmoney/.

Проверка безопасности

• Требует токен доступа к финансовым данным
• Синхронизирует данные с ZenMoney API и хранит их локально

Коротко о README

README описывает Go-клиент ZenMoney API и CLI zm с командами auth, sync, accounts, tx, cats и summary. Приведены три варианта подключения скилла Claude Code: личный скилл, --add-dir и скилл проекта. Раздел библиотеки показывает полную и инкрементальную синхронизацию, отправку изменений, OAuth2 и локальное хранилище. Все сущности ZenMoney API отображены в Go-структуры.

SKILL.md

---
name: zenmoney
description: Query personal finances via ZenMoney API. Use when the user asks about money, finances, accounts, balances, transactions, spending, income, expenses, budget, net worth, savings, or cash flow.
argument-hint: "[question or zm command]"
allowed-tools: Bash(zm *)
---

# ZenMoney Finance CLI

You have access to `zm` — a CLI that syncs and queries financial data from ZenMoney.

ZenMoney connects to Russian banks (Tinkoff, Sber, Alfa, etc.) and imports transactions automatically via SMS/push parsing on the user's phone. The `zm` CLI reads that data through the ZenMoney API.

## Commands

```
zm sync                   # Pull latest data (incremental)
zm sync --full            # Force full re-sync from scratch
zm accounts               # List accounts with balances and currency
zm accounts --all         # Include archived accounts
zm tx                     # Last 30 transactions
zm tx --limit N           # Last N transactions (0 = unlimited)
zm tx --from YYYY-MM-DD   # Start date filter
zm tx --to YYYY-MM-DD     # End date filter
zm tx --account "text"    # Filter by account name (case-insensitive substring)
zm tx --tag "text"        # Filter by category name (case-insensitive substring)
zm cats                   # List categories as a tree
zm summary                # Monthly income/expense/net + net worth (last 3 months)
zm summary --months N     # Last N months
```

## Workflow

1. **Sync first** — run `zm sync` before answering if you haven't synced this session.
2. **Compute** — the CLI outputs raw data. Sum totals, compute averages, compare periods, spot trends yourself.
3. **Combine commands** — a question like "how much did I spend on food in March?" needs `zm tx --tag "..." --from ... --to ... --limit 0`, then sum the outcome amounts.
4. **Transfers** — transactions with both income > 0 and outcome > 0 between different accounts are transfers, not income/expense. `zm summary` already handles this.
5. **Multi-currency** — accounts can be in different currencies (RUB, USD, USDT, etc.). The CURRENCY column in `zm accounts` shows which. `zm summary` converts to the user's base currency.

Похожие