← Back to Skills Marketplace
Beancount
by
bytesagain-lab
· GitHub ↗
· v2.0.0
· MIT-0
385
Downloads
0
Stars
1
Active Installs
6
Versions
Install in OpenClaw
/install beancount
Description
Personal bookkeeping assistant for local income and expense tracking, monthly reports with comparisons, budget alerts, and savings goal management.
README (SKILL.md)
bookkeeping
记账管家。收支记录、月度报表（含同比环比）、预算管理、存钱目标追踪。数据存本地JSON。
Commands
All commands via scripts/book.sh:
| Command | Usage | Description |
|---|---|---|
add |
book.sh add "金额" "类别" "备注" [--type income|expense] |
记一笔账（默认expense） |
list |
book.sh list [--month 2026-03] |
查看记录（默认当月） |
report |
book.sh report [--month 2026-03] |
月度收支报表（含同比环比+分类饼图+支出TOP3） |
budget |
book.sh budget "类别" "月预算" |
设置类别月预算（超支自动提醒） |
goal |
book.sh goal "目标名" "金额" "月数" |
设置存钱目标（计算每月需存） |
goal-save |
book.sh goal-save "目标名" "金额" |
往目标里存钱 |
goals |
book.sh goals |
查看所有存钱目标进度 |
help |
book.sh help |
显示帮助信息 |
Data Storage
- 记录文件:
~/.bookkeeping/records.json - 预算文件:
~/.bookkeeping/budgets.json - 目标文件:
~/.bookkeeping/goals.json - 自动创建目录和文件
Examples
# 记一笔支出
bash scripts/book.sh add 35.5 餐饮 "午餐外卖"
# 记一笔收入
bash scripts/book.sh add 15000 工资 "3月工资" --type income
# 查看当月记录
bash scripts/book.sh list
# 查看指定月份
bash scripts/book.sh list --month 2026-02
# 生成月度报表（含同比环比）
bash scripts/book.sh report
# 设置餐饮预算
bash scripts/book.sh budget 餐饮 2000
# 设置存钱目标（6个月存8000）
bash scripts/book.sh goal "买相机" 8000 6
# 往目标存钱
bash scripts/book.sh goal-save "买相机" 1500
# 查看所有目标进度
bash scripts/book.sh goals
Categories (建议)
- 支出: 餐饮、交通、购物、娱乐、居住、医疗、教育、其他
- 收入: 工资、奖金、理财、兼职、其他
Reference
- 参考文档:
tips.md— 记账理财小贴士（50-30-20法则、存钱技巧等）
Notes
- 数据存储在
~/.bookkeeping/目录 - JSON 格式，可手动编辑
- 纯本地运行，无需联网
- Python 3.6+ 兼容
💬 Feedback & Feature Requests: https://bytesagain.com/feedback Powered by BytesAgain | bytesagain.com
Usage Guidance
This skill implements a local bookkeeping tool and appears to do only local file read/write in your home directory. Before installing: (1) review and trust the source (files include an extra scripts/script.sh that is not referenced by SKILL.md), (2) be aware it will create ~/.bookkeeping/records.json, budgets.json, goals.json (and scripts/script.sh may use ~/.local/share/beancount), (3) if your records are sensitive consider encrypting/backing up those files or placing them in an encrypted directory, and (4) if you don't need the extra scripts, remove them after inspection. If you want higher assurance, ask the maintainer for provenance (commit history or release page) or run the scripts in a sandbox first.
Capability Analysis
Type: OpenClaw Skill
Name: beancount
Version: 2.0.0
The skill provides local bookkeeping and financial management functionality, including expense tracking, budgeting, and savings goals. All data is stored locally in JSON format within the user's home directory (~/.bookkeeping), and the scripts (scripts/book.sh and scripts/script.sh) contain no network calls, obfuscation, or unauthorized file access. The logic is transparent and aligns perfectly with the stated purpose in SKILL.md.
Capability Assessment
Purpose & Capability
SKILL.md and scripts/book.sh align: personal bookkeeping, local JSON storage in ~/.bookkeeping, commands implemented in scripts/book.sh. One extra companion script (scripts/script.sh) is included that uses a different data directory (~/.local/share/beancount) and provides a generic CLI; it is not referenced by the SKILL.md commands. The extra script is likely benign but unnecessary and should be noted.
Instruction Scope
Runtime instructions (SKILL.md) say data is stored locally and scripts/book.sh only reads/writes files under the user's home (~/.bookkeeping). There are no network calls, no reads of unrelated system files, and no access to credentials in the provided code.
Install Mechanism
No install spec; this is an instruction+script bundle. No downloads or archive extraction are present in the package, so nothing is written to disk beyond the included files and the data files the scripts deliberately create.
Credentials
The skill declares no required environment variables or credentials. The scripts respect common environment conventions: scripts/script.sh will honor BEANCOUNT_DIR or XDG_DATA_HOME if set, and both scripts expand $HOME for data storage. That use is reasonable and optional, not required.
Persistence & Privilege
always is false and the skill does not modify other skills or system-wide settings. It creates and writes its own data files under the user's home directory only.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install beancount - After installation, invoke the skill by name or use
/beancount - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
v2.5 standard: Use-when desc, homepage, source, security fix
v1.0.4
yaml-fix+quality
v1.0.3
yaml-fix+quality
v1.0.2
Quality upgrade
v1.0.1
Quality upgrade: custom functionality
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is Beancount?
Personal bookkeeping assistant for local income and expense tracking, monthly reports with comparisons, budget alerts, and savings goal management. It is an AI Agent Skill for Claude Code / OpenClaw, with 385 downloads so far.
How do I install Beancount?
Run "/install beancount" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Beancount free?
Yes, Beancount is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Beancount support?
Beancount is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Beancount?
It is built and maintained by bytesagain-lab (@bytesagain-lab); the current version is v2.0.0.
More Skills