Intelligent budget tracking and financial management library for AI agents - expense tracking, income management, budgets, savings goals, and LLM-powered insights
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
A TypeScript library for AI agents to track expenses, income, budgets, and savings goals with LLM-powered natural language parsing. No frontend required - designed for programmatic use by agents and bots.
npm install agent-money-tracker
import { clawhub } from 'agent-money-tracker';// Initialize (required before any operations) await clawhub.initialize();
// Or with custom storage path await clawhub.initialize('/path/to/data');
// Add an expense await clawhub.addExpense(50, 'Food & Dining', 'Grocery shopping', { date: '2026-01-31', tags: ['weekly', 'essentials'], merchant: 'Whole Foods' });// Natural language input await clawhub.addFromNaturalLanguage('spent $45 on uber yesterday');
// Get recent expenses const expenses = clawhub.getExpenses({ limit: 10 });
// Filter by category and date range const foodExpenses = clawhub.getExpenses({ category: 'Food & Dining', startDate: '2026-01-01', endDate: '2026-01-31' });
// Add income await clawhub.addIncome(5000, 'Salary', 'January salary', { date: '2026-01-15' });// Add freelance income await clawhub.addIncome(500, 'Freelance', 'Website project');
// Get all income const income = clawhub.getIncome();
// Create a monthly budget await clawhub.createBudget('Food Budget', 'Food & Dining', 500, 'monthly', 0.8);// Check budget status const status = clawhub.getBudgetStatus(); // Returns: [{ budgetName, spent, limit, remaining, percentageUsed, status }]
// Get budget alerts const alerts = clawhub.checkBudgetAlerts(); // Returns warnings when threshold or limit exceeded
// Get smart budget suggestions const suggestions = clawhub.suggestBudgetLimits(); // Returns: [{ category, suggested, average, max }]
// Create a savings goal await clawhub.createGoal('Emergency Fund', 10000, { description: '6 months expenses', deadline: '2026-12-31', priority: 'high' });// Add contribution await clawhub.contributeToGoal('goal_abc123', 500, 'January savings');
// Check progress const progress = clawhub.getGoalProgress(); // Returns: [{ goalName, targetAmount, currentAmount, percentageComplete, daysRemaining, onTrack }]
// Monthly spending summary const summary = clawhub.getSpendingSummary(); // Returns: { totalExpenses, totalIncome, netSavings, expensesByCategory, incomeByCategory }// View monthly trends const trends = clawhub.getMonthlyTrends(12); // Returns: [{ date, expenses, income, netSavings }]
// Full monthly report const report = clawhub.generateMonthlyReport(2026, 1);
// Compare to last month const comparison = clawhub.compareToLastMonth(); // Returns: { expenseChange, incomeChange, topIncreases, topDecreases }
// Generate AI-powered insights const insights = await clawhub.generateInsights(); // Returns insights like: // - "โ ๏ธ Your dining expenses are 3x higher than usual" // - "๐ก Cancel unused subscriptions to save $50/month" // - "๐ You've tracked expenses for 7 consecutive days!"// Get unread insights const unreadInsights = clawhub.getInsights();
// Create recurring expense (e.g., Netflix subscription) await clawhub.createRecurring( 'expense', 15.99, 'Subscriptions', 'Netflix', 'monthly', { startDate: '2026-02-01' } );// Create recurring income (e.g., salary) await clawhub.createRecurring( 'income', 5000, 'Salary', 'Monthly salary', 'monthly' );
// Process due recurring transactions await clawhub.processRecurring();
// Get statistics const stats = clawhub.getStats(); // Returns: { totalTransactions, totalExpenses, totalIncome, netSavings, avgExpense, topCategory }// Get available categories const categories = clawhub.getCategories();
// Export data const jsonData = await clawhub.exportData();
// Create backup const backupPath = await clawhub.backup();
// Get storage location const dataPath = clawhub.getDataPath();
| Category | Icon |
|---|---|
| Food & Dining | ๐ |
| Transportation | ๐ |
| Shopping | ๐๏ธ |
| Bills & Utilities | ๐ก |
| Entertainment | ๐ฌ |
| Health & Fitness | ๐ช |
| Education | ๐ |
| Personal Care | ๐ |
| Subscriptions | ๐ฑ |
| Category | Icon |
|---|---|
| Salary | ๐ฐ |
| Freelance | ๐ป |
| Investments | ๐ |
| Gifts | ๐ |
Data is stored in platform-specific locations:
| Platform | Default Path |
|---|---|
| Windows | |
| macOS | |
| Linux | |
Override with environment variable:
export CLAWHUB_DATA_PATH=/custom/path
| Method | Description |
|---|---|
| Initialize the budget tracker |
| Add expense |
| Add income |
| Parse and add from natural language |
| Create budget |
| Get all budget statuses |
| Get budget warnings/alerts |
| Create savings goal |
| Add to goal |
| Get all goal progress |
| Get spending breakdown |
| Get monthly trend data |
| Generate full report |
| Generate AI insights |
| Create recurring |
| Process due recurring transactions |
| Get transaction statistics |
| Export all data as JSON |
| Create timestamped backup |
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
ยฉ 2026 Torly.ai. All rights reserved.