Agent Ledger
Track your agent's earnings and payments. Built for AI agents that do real work and get paid for it.
Quick Start
# Log a completed task
bash scripts/ledger.sh add "Research report for client" 10.00
# Check your balance
bash scripts/ledger.sh balance
# List all tasks
bash scripts/ledger.sh list
# Mark a task as paid
bash scripts/ledger.sh pay 1
# View summary stats
bash scripts/ledger.sh stats
# Export as CSV
bash scripts/ledger.sh export csv
Commands
| Command | Args | Description |
|---|---|---|
add | "description" amount [pending|paid] | Log a task with amount |
balance | 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)config.json— wallet address, preferences
Rate Card Template
Set your rates in config.json:
{
"wallet": "0x...",
"rates": {
"quick_lookup": 0,
"research": "3-10",
"automation": "10-25",
"deep_project": "25-100"
}
}
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.