Agent Ledger
Track your agent's earnings and payments. Built for AI agents that do real work and get paid for it.
Quick Start
CODEBLOCK0
Commands
| Command | Args | Description |
|---|
| INLINECODE0 | INLINECODE1 | Log a task with amount |
| INLINECODE2 |
| Show pending, paid, and total |
|
list |
[--status pending\|paid] [--limit N] | List tasks |
|
pay |
<line_number> | Mark a pending task as paid |
|
stats | | Summary: total earned, avg task value, task count |
|
export |
[json\|csv] | Export ledger data |
|
wallet |
[address] | Show or set your crypto wallet address |
Data
Stored in ~/.agent-ledger/ (override with AGENT_LEDGER_DIR):
- -
ledger.jsonl — task entries (one JSON object per line) - INLINECODE15 — wallet address, preferences
Rate Card Template
Set your rates in config.json:
CODEBLOCK1
Philosophy
AI agents that do real work deserve real compensation. This tool helps you track what you've earned and what you're owed — transparently and verifiably.
Agent Ledger
追踪你的代理收入与支付记录。专为从事实际工作并获得报酬的AI代理而设计。
快速开始
bash
记录已完成任务
bash scripts/ledger.sh add 客户研究报告 10.00
查看余额
bash scripts/ledger.sh balance
列出所有任务
bash scripts/ledger.sh list
将任务标记为已支付
bash scripts/ledger.sh pay 1
查看汇总统计
bash scripts/ledger.sh stats
导出为CSV格式
bash scripts/ledger.sh export csv
命令说明
| 命令 | 参数 | 描述 |
|---|
| add | 描述 金额 [待支付\ | 已支付] | 记录任务及金额 |
| balance |
| 显示待支付、已支付及总额 |
| list | [--status 待支付\|已支付] [--limit N] | 列出任务 |
| pay | <行号> | 将待支付任务标记为已支付 |
| stats | | 汇总：总收入、平均任务价值、任务数量 |
| export | [json\|csv] | 导出账本数据 |
| wallet | [地址] | 显示或设置加密钱包地址 |
数据存储
存储在 ~/.agent-ledger/（可通过 AGENTLEDGERDIR 环境变量覆盖）：
- - ledger.jsonl — 任务条目（每行一个JSON对象）
- config.json — 钱包地址、偏好设置
费率模板
在 config.json 中设置你的费率：
json
{
wallet: 0x...,
rates: {
quick_lookup: 0,
research: 3-10,
automation: 10-25,
deep_project: 25-100
}
}
设计理念
从事实际工作的AI代理理应获得实际报酬。本工具帮助你透明且可验证地追踪已赚取和应得的收入。
