{
  "schemaVersion": "1.0",
  "item": {
    "slug": "intelligent-budget-tracker",
    "name": "Intelligent Budget Tracker",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/enjuguna/intelligent-budget-tracker",
    "canonicalUrl": "https://clawhub.ai/enjuguna/intelligent-budget-tracker",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/intelligent-budget-tracker",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=intelligent-budget-tracker",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/intelligent-budget-tracker"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/intelligent-budget-tracker",
    "agentPageUrl": "https://openagent3.xyz/skills/intelligent-budget-tracker/agent",
    "manifestUrl": "https://openagent3.xyz/skills/intelligent-budget-tracker/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/intelligent-budget-tracker/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Agent Money Tracker",
        "body": "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."
      },
      {
        "title": "Installation",
        "body": "npm install agent-money-tracker"
      },
      {
        "title": "Initialize the Budget Tracker",
        "body": "import { clawhub } from 'agent-money-tracker';\n\n// Initialize (required before any operations)\nawait clawhub.initialize();\n\n// Or with custom storage path\nawait clawhub.initialize('/path/to/data');"
      },
      {
        "title": "Expense Tracking",
        "body": "// Add an expense\nawait clawhub.addExpense(50, 'Food & Dining', 'Grocery shopping', {\n  date: '2026-01-31',\n  tags: ['weekly', 'essentials'],\n  merchant: 'Whole Foods'\n});\n\n// Natural language input\nawait clawhub.addFromNaturalLanguage('spent $45 on uber yesterday');\n\n// Get recent expenses\nconst expenses = clawhub.getExpenses({ limit: 10 });\n\n// Filter by category and date range\nconst foodExpenses = clawhub.getExpenses({\n  category: 'Food & Dining',\n  startDate: '2026-01-01',\n  endDate: '2026-01-31'\n});"
      },
      {
        "title": "Income Tracking",
        "body": "// Add income\nawait clawhub.addIncome(5000, 'Salary', 'January salary', {\n  date: '2026-01-15'\n});\n\n// Add freelance income\nawait clawhub.addIncome(500, 'Freelance', 'Website project');\n\n// Get all income\nconst income = clawhub.getIncome();"
      },
      {
        "title": "Budget Management",
        "body": "// Create a monthly budget\nawait clawhub.createBudget('Food Budget', 'Food & Dining', 500, 'monthly', 0.8);\n\n// Check budget status\nconst status = clawhub.getBudgetStatus();\n// Returns: [{ budgetName, spent, limit, remaining, percentageUsed, status }]\n\n// Get budget alerts\nconst alerts = clawhub.checkBudgetAlerts();\n// Returns warnings when threshold or limit exceeded\n\n// Get smart budget suggestions\nconst suggestions = clawhub.suggestBudgetLimits();\n// Returns: [{ category, suggested, average, max }]"
      },
      {
        "title": "Savings Goals",
        "body": "// Create a savings goal\nawait clawhub.createGoal('Emergency Fund', 10000, {\n  description: '6 months expenses',\n  deadline: '2026-12-31',\n  priority: 'high'\n});\n\n// Add contribution\nawait clawhub.contributeToGoal('goal_abc123', 500, 'January savings');\n\n// Check progress\nconst progress = clawhub.getGoalProgress();\n// Returns: [{ goalName, targetAmount, currentAmount, percentageComplete, daysRemaining, onTrack }]"
      },
      {
        "title": "Analytics & Reports",
        "body": "// Monthly spending summary\nconst summary = clawhub.getSpendingSummary();\n// Returns: { totalExpenses, totalIncome, netSavings, expensesByCategory, incomeByCategory }\n\n// View monthly trends\nconst trends = clawhub.getMonthlyTrends(12);\n// Returns: [{ date, expenses, income, netSavings }]\n\n// Full monthly report\nconst report = clawhub.generateMonthlyReport(2026, 1);\n\n// Compare to last month\nconst comparison = clawhub.compareToLastMonth();\n// Returns: { expenseChange, incomeChange, topIncreases, topDecreases }"
      },
      {
        "title": "Smart Insights",
        "body": "// Generate AI-powered insights\nconst insights = await clawhub.generateInsights();\n// Returns insights like:\n// - \"⚠️ Your dining expenses are 3x higher than usual\"\n// - \"💡 Cancel unused subscriptions to save $50/month\"\n// - \"🏆 You've tracked expenses for 7 consecutive days!\"\n\n// Get unread insights\nconst unreadInsights = clawhub.getInsights();"
      },
      {
        "title": "Recurring Transactions",
        "body": "// Create recurring expense (e.g., Netflix subscription)\nawait clawhub.createRecurring(\n  'expense', 15.99, 'Subscriptions', 'Netflix', 'monthly',\n  { startDate: '2026-02-01' }\n);\n\n// Create recurring income (e.g., salary)\nawait clawhub.createRecurring(\n  'income', 5000, 'Salary', 'Monthly salary', 'monthly'\n);\n\n// Process due recurring transactions\nawait clawhub.processRecurring();"
      },
      {
        "title": "Data Management",
        "body": "// Get statistics\nconst stats = clawhub.getStats();\n// Returns: { totalTransactions, totalExpenses, totalIncome, netSavings, avgExpense, topCategory }\n\n// Get available categories\nconst categories = clawhub.getCategories();\n\n// Export data\nconst jsonData = await clawhub.exportData();\n\n// Create backup\nconst backupPath = await clawhub.backup();\n\n// Get storage location\nconst dataPath = clawhub.getDataPath();"
      },
      {
        "title": "Expense Categories",
        "body": "CategoryIconFood & Dining🍔Transportation🚗Shopping🛍️Bills & Utilities💡Entertainment🎬Health & Fitness💪Education📚Personal Care💄Subscriptions📱"
      },
      {
        "title": "Income Categories",
        "body": "CategoryIconSalary💰Freelance💻Investments📈Gifts🎁"
      },
      {
        "title": "Cross-Platform Storage",
        "body": "Data is stored in platform-specific locations:\n\nPlatformDefault PathWindows%APPDATA%\\clawhubmacOS~/Library/Application Support/clawhubLinux~/.local/share/clawhub\n\nOverride with environment variable:\n\nexport CLAWHUB_DATA_PATH=/custom/path"
      },
      {
        "title": "API Reference Summary",
        "body": "MethodDescriptioninitialize(path?)Initialize the budget trackeraddExpense(amount, category, description, options?)Add expenseaddIncome(amount, category, description, options?)Add incomeaddFromNaturalLanguage(text)Parse and add from natural languagecreateBudget(name, category, limit, period, threshold?)Create budgetgetBudgetStatus()Get all budget statusescheckBudgetAlerts()Get budget warnings/alertscreateGoal(name, target, options?)Create savings goalcontributeToGoal(goalId, amount, note?)Add to goalgetGoalProgress()Get all goal progressgetSpendingSummary(start?, end?)Get spending breakdowngetMonthlyTrends(months?)Get monthly trend datagenerateMonthlyReport(year?, month?)Generate full reportgenerateInsights()Generate AI insightscreateRecurring(type, amount, category, desc, freq, options?)Create recurringprocessRecurring()Process due recurring transactionsgetStats()Get transaction statisticsexportData()Export all data as JSONbackup()Create timestamped backup"
      }
    ],
    "body": "Agent Money Tracker\n\nA 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.\n\nInstallation\nnpm install agent-money-tracker\n\nUsage\nInitialize the Budget Tracker\nimport { clawhub } from 'agent-money-tracker';\n\n// Initialize (required before any operations)\nawait clawhub.initialize();\n\n// Or with custom storage path\nawait clawhub.initialize('/path/to/data');\n\nExpense Tracking\n// Add an expense\nawait clawhub.addExpense(50, 'Food & Dining', 'Grocery shopping', {\n  date: '2026-01-31',\n  tags: ['weekly', 'essentials'],\n  merchant: 'Whole Foods'\n});\n\n// Natural language input\nawait clawhub.addFromNaturalLanguage('spent $45 on uber yesterday');\n\n// Get recent expenses\nconst expenses = clawhub.getExpenses({ limit: 10 });\n\n// Filter by category and date range\nconst foodExpenses = clawhub.getExpenses({\n  category: 'Food & Dining',\n  startDate: '2026-01-01',\n  endDate: '2026-01-31'\n});\n\nIncome Tracking\n// Add income\nawait clawhub.addIncome(5000, 'Salary', 'January salary', {\n  date: '2026-01-15'\n});\n\n// Add freelance income\nawait clawhub.addIncome(500, 'Freelance', 'Website project');\n\n// Get all income\nconst income = clawhub.getIncome();\n\nBudget Management\n// Create a monthly budget\nawait clawhub.createBudget('Food Budget', 'Food & Dining', 500, 'monthly', 0.8);\n\n// Check budget status\nconst status = clawhub.getBudgetStatus();\n// Returns: [{ budgetName, spent, limit, remaining, percentageUsed, status }]\n\n// Get budget alerts\nconst alerts = clawhub.checkBudgetAlerts();\n// Returns warnings when threshold or limit exceeded\n\n// Get smart budget suggestions\nconst suggestions = clawhub.suggestBudgetLimits();\n// Returns: [{ category, suggested, average, max }]\n\nSavings Goals\n// Create a savings goal\nawait clawhub.createGoal('Emergency Fund', 10000, {\n  description: '6 months expenses',\n  deadline: '2026-12-31',\n  priority: 'high'\n});\n\n// Add contribution\nawait clawhub.contributeToGoal('goal_abc123', 500, 'January savings');\n\n// Check progress\nconst progress = clawhub.getGoalProgress();\n// Returns: [{ goalName, targetAmount, currentAmount, percentageComplete, daysRemaining, onTrack }]\n\nAnalytics & Reports\n// Monthly spending summary\nconst summary = clawhub.getSpendingSummary();\n// Returns: { totalExpenses, totalIncome, netSavings, expensesByCategory, incomeByCategory }\n\n// View monthly trends\nconst trends = clawhub.getMonthlyTrends(12);\n// Returns: [{ date, expenses, income, netSavings }]\n\n// Full monthly report\nconst report = clawhub.generateMonthlyReport(2026, 1);\n\n// Compare to last month\nconst comparison = clawhub.compareToLastMonth();\n// Returns: { expenseChange, incomeChange, topIncreases, topDecreases }\n\nSmart Insights\n// Generate AI-powered insights\nconst insights = await clawhub.generateInsights();\n// Returns insights like:\n// - \"⚠️ Your dining expenses are 3x higher than usual\"\n// - \"💡 Cancel unused subscriptions to save $50/month\"\n// - \"🏆 You've tracked expenses for 7 consecutive days!\"\n\n// Get unread insights\nconst unreadInsights = clawhub.getInsights();\n\nRecurring Transactions\n// Create recurring expense (e.g., Netflix subscription)\nawait clawhub.createRecurring(\n  'expense', 15.99, 'Subscriptions', 'Netflix', 'monthly',\n  { startDate: '2026-02-01' }\n);\n\n// Create recurring income (e.g., salary)\nawait clawhub.createRecurring(\n  'income', 5000, 'Salary', 'Monthly salary', 'monthly'\n);\n\n// Process due recurring transactions\nawait clawhub.processRecurring();\n\nData Management\n// Get statistics\nconst stats = clawhub.getStats();\n// Returns: { totalTransactions, totalExpenses, totalIncome, netSavings, avgExpense, topCategory }\n\n// Get available categories\nconst categories = clawhub.getCategories();\n\n// Export data\nconst jsonData = await clawhub.exportData();\n\n// Create backup\nconst backupPath = await clawhub.backup();\n\n// Get storage location\nconst dataPath = clawhub.getDataPath();\n\nDefault Categories\nExpense Categories\nCategory\tIcon\nFood & Dining\t🍔\nTransportation\t🚗\nShopping\t🛍️\nBills & Utilities\t💡\nEntertainment\t🎬\nHealth & Fitness\t💪\nEducation\t📚\nPersonal Care\t💄\nSubscriptions\t📱\nIncome Categories\nCategory\tIcon\nSalary\t💰\nFreelance\t💻\nInvestments\t📈\nGifts\t🎁\nCross-Platform Storage\n\nData is stored in platform-specific locations:\n\nPlatform\tDefault Path\nWindows\t%APPDATA%\\clawhub\nmacOS\t~/Library/Application Support/clawhub\nLinux\t~/.local/share/clawhub\n\nOverride with environment variable:\n\nexport CLAWHUB_DATA_PATH=/custom/path\n\nAPI Reference Summary\nMethod\tDescription\ninitialize(path?)\tInitialize the budget tracker\naddExpense(amount, category, description, options?)\tAdd expense\naddIncome(amount, category, description, options?)\tAdd income\naddFromNaturalLanguage(text)\tParse and add from natural language\ncreateBudget(name, category, limit, period, threshold?)\tCreate budget\ngetBudgetStatus()\tGet all budget statuses\ncheckBudgetAlerts()\tGet budget warnings/alerts\ncreateGoal(name, target, options?)\tCreate savings goal\ncontributeToGoal(goalId, amount, note?)\tAdd to goal\ngetGoalProgress()\tGet all goal progress\ngetSpendingSummary(start?, end?)\tGet spending breakdown\ngetMonthlyTrends(months?)\tGet monthly trend data\ngenerateMonthlyReport(year?, month?)\tGenerate full report\ngenerateInsights()\tGenerate AI insights\ncreateRecurring(type, amount, category, desc, freq, options?)\tCreate recurring\nprocessRecurring()\tProcess due recurring transactions\ngetStats()\tGet transaction statistics\nexportData()\tExport all data as JSON\nbackup()\tCreate timestamped backup"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/enjuguna/intelligent-budget-tracker",
    "publisherUrl": "https://clawhub.ai/enjuguna/intelligent-budget-tracker",
    "owner": "enjuguna",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/intelligent-budget-tracker",
    "downloadUrl": "https://openagent3.xyz/downloads/intelligent-budget-tracker",
    "agentUrl": "https://openagent3.xyz/skills/intelligent-budget-tracker/agent",
    "manifestUrl": "https://openagent3.xyz/skills/intelligent-budget-tracker/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/intelligent-budget-tracker/agent.md"
  }
}