🧠 AI Agent Skill — Let your agent track your daily expenses in natural language. Zero UI, data stays local. Works with OpenClaw · Claude Code · and any agent runtime that can shell out.

跟 AI 说句话就记好账。不用打开 APP，不用登录，数据全在本地。

这是一个 AI agent skill：让你的 AI 助手直接负责记账，你只需要用自然语言说出来。

跟你的 agent 说：

• "午饭 35" → agent 调 ledger add 记一笔 35 元饮食支出
• "昨天买了瓶水 3 块" → agent 带日期记录
• "这个月我吃了多少钱" → agent 调 ledger query 统计分类汇总
• "本周总支出" → agent 给你周报

支持的 agent 运行时：

• OpenClaw —— 自托管多 agent 编排平台
• Claude Code —— 可通过 bash tool 调用
• 任何支持 shell 执行的 agent 框架（Cursor / Aider / Codex CLI / Continue / Gemini CLI / ...）

也能当纯 CLI 用：不用 agent 直接 ledger add 午饭 35 也完全可以。

用了十几年随手记，每次记账要：打开 APP → 选分类 → 输金额 → 保存。

现在只需要跟 AI 说一句：

"午饭 35"

搞定。

• 你已经在用 AI Agent（OpenClaw / Claude Code / Codex 等）
• 你懒得每次打开记账 APP
• 你不信任云端存你的消费数据
• 你想要的只是记下来、偶尔看看，不需要花哨的图表

跟你的 Agent 说：

"学习这个 skill：https://github.com/OutmanSay/ledger-cli"

然后直接开始：

"午饭 35" "打车 18 去公司" "今天花了多少"

git clone https://github.com/OutmanSay/ledger-cli.git
cd ledger-cli

# 记一笔
python3 ledger_tool.py add -a 35 -c 午饭

# 今天花了多少
python3 ledger_tool.py today

# 本月汇总
python3 ledger_tool.py month

无需安装依赖，Python 3 + SQLite（系统自带）就够了。

所有数据存在 ledger.db（SQLite 单文件），和脚本同目录。

• 不上传云端
• 不需要注册账号
• 可以用任何 SQLite 工具打开
• 可以随时导出 CSV

如果你之前用随手记，可以导出 XLS 后一键导入历史数据。（导入脚本见项目内说明）

# 记一笔
python3 ledger_tool.py add --amount 35 --category 午饭 --note "公司食堂"

# 查询
python3 ledger_tool.py today              # 今日支出
python3 ledger_tool.py month              # 本月汇总
python3 ledger_tool.py month 2026-03      # 指定月
python3 ledger_tool.py recent             # 最近 10 笔
python3 ledger_tool.py recent -n 20       # 最近 20 笔
python3 ledger_tool.py category 餐饮      # 查分类
python3 ledger_tool.py search 奶茶        # 搜索
python3 ledger_tool.py stats              # 本月统计
python3 ledger_tool.py year               # 年度汇总
python3 ledger_tool.py year 2025          # 指定年

口语化输入，自动归类：

MIT