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.
