← Back to Skills Marketplace

Budget Tracker

Name: Budget Tracker
Author: ckchzh

by BytesAgain2 · GitHub ↗ · v2.0.0 · MIT-0

cross-platform ✓ Security Clean

209

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install budget-tracker

Description

Track income, expenses, and generate monthly reports locally. 支持多币种记账、预算设置及收支报表生成。Use when managing personal finances, tracking project costs, or auditing mo...

README (SKILL.md)

Budget Tracker / 楼台理财助手

Your personal financial auditor that stays 100% local and private.

Quick Start / 快速开始

Just ask your AI assistant: / 直接告诉 AI 助手：

"Log an expense: $50 for dinner today" (记录今日晚餐支出50元)
"I earned $2000 from a freelance project" (记录一笔2000元的自由职业收入)
"Show my spending summary for March 2026" (显示2026年3月的收支汇总)

When to Use / 使用场景

Daily Expenses: Keeping track of where every penny goes.
Budget Control: Setting limits and getting alerts for overspending.
Data Export: Generating clean CSV reports for your accountant.

Commands / 常用功能

add

Record an income or expense.

bash scripts/script.sh add --amount -50 --category "Food" --note "Dinner"

list

Show recent transactions.

bash scripts/script.sh list

report

Generate a monthly financial summary.

bash scripts/script.sh report --month "2026-03"

Requirements / 要求

bash 4+
python3

Feedback

Report issues or suggest features: https://bytesagain.com/feedback/

Usage Guidance

This skill appears to do what it claims and stores everything locally in ~/.budget-tracker/ledger.json. Before installing: ensure you have bash and python3, review or backup the ledger file if you already use ~/.budget-tracker, and confirm the currency handling meets your needs (the script prints ¥ and does not expose explicit currency fields). Because it writes a file in your home directory, consider file permissions and backups; there are no network calls or credential requests in the provided code.

Capability Analysis

Type: OpenClaw Skill Name: budget-tracker Version: 2.0.0 The budget-tracker skill is a legitimate local financial management tool. It uses a bash script (scripts/script.sh) to wrap an inline Python script that manages a local JSON database in the user's home directory (~/.budget-tracker/ledger.json). The code performs standard CRUD operations for expenses and income without any network activity, data exfiltration, or suspicious execution patterns.

Capability Assessment

ℹ Purpose & Capability

The name/description (local personal finance tracker) matches the files and behavior: the script records transactions, lists recent entries, and prints a report. Minor mismatch: the description claims multi-currency support, but the implementation prints a fixed ¥ symbol and does not show currency fields in entries.

✓ Instruction Scope

SKILL.md instructs the agent to run the included scripts/script.sh commands (add, list, report). The script operates only on a local JSON ledger in the user's home directory and does not access other filesystem paths or environment variables beyond $HOME.

✓ Install Mechanism

No install spec is provided (instruction-only with a bundled helper script). No network downloads or package installs occur at runtime.

✓ Credentials

The skill requests no environment variables, credentials, or config paths. It only uses $HOME to create ~/.budget-tracker and passes the DB path to the embedded python via DATA_FILE — this is proportional to its stated purpose.

✓ Persistence & Privilege

The skill persists data locally by creating ~/.budget-tracker/ledger.json. It does not request always:true, does not modify other skills' configs, and does not require elevated privileges.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install budget-tracker
After installation, invoke the skill by name or use /budget-tracker
Provide required inputs per the skill's parameter spec and get structured output

Version History

v2.0.0

Final Quality & Bilingual Polishing

Metadata

Slug budget-tracker

Version 2.0.0

License MIT-0

All-time Installs 1

Active Installs 1

Total Versions 1

Frequently Asked Questions

What is Budget Tracker?

Track income, expenses, and generate monthly reports locally. 支持多币种记账、预算设置及收支报表生成。Use when managing personal finances, tracking project costs, or auditing mo... It is an AI Agent Skill for Claude Code / OpenClaw, with 209 downloads so far.

How do I install Budget Tracker?

Run "/install budget-tracker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Budget Tracker free?

Yes, Budget Tracker is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Budget Tracker support?

Budget Tracker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Budget Tracker?

It is built and maintained by BytesAgain2 (@ckchzh); the current version is v2.0.0.

More Skills