actual-budget-assistant
npx skills add https://github.com/tifandotme/dotfiles --skill actual-budget-assistant
Agent 安装分布
Skill 文档
Actual Budget Assistant
Query your Actual Budget data using natural language. This skill helps you analyze transactions, check balances, and review spending across accounts.
Prerequisites
Install the Actual Budget API package globally:
npm install -g @actual-app/api
Required environment variables:
export ACTUAL_SERVER_URL=https://actual.example.com
export ACTUAL_PASSWORD=yourpassword
export ACTUAL_SYNC_ID=your-sync-id
How to Use
When the user asks budget-related questions, use the scripts in scripts/ directory to fetch data.
Available Scripts
| Script | Purpose |
|---|---|
list-accounts.js |
List all accounts with balances |
list-transactions.js |
Query transactions with filters |
get-balance.js |
Get account balance(s) |
list-categories.js |
List budget categories |
Handling User Queries
User asks: “List my transactions in account BCA in last january 2026”
node scripts/list-transactions.js --account="BCA" --date="last january 2026"
User asks: “What’s my BCA balance?”
node scripts/get-balance.js --account="BCA"
User asks: “Show my spending last month” (account not specified)
node scripts/list-accounts.js
Then ask: “Which account? You have: [list from output]”
When Account is Not Specified
If the user doesn’t specify which account, run list-accounts.js first, then ask them to clarify:
“Which account? You have: BCA, Mandiri, Cash, Investment”
Date Parsing
The scripts accept flexible date formats:
last january 2026â January 2026january 2026â January 2026last monthâ Previous full monththis monthâ Current month2026-01â January 20262026-01-15â Specific day
Fuzzy Account Matching
Account names are matched case-insensitively:
BCAmatches “BCA”, “Rekening BCA”, “My BCA Account”- If no match found, script lists all available accounts
JSON Output
Add --json to any script for structured output:
node scripts/list-transactions.js --account="BCA" --date="last month" --json