Hledger

SKILL.md

# hledger Skill for OpenClaw

The **hledger skill** allows OpenClaw agents to execute `hledger` CLI commands
on the host system and return structured output to the user.

This skill acts as a thin wrapper around the installed `hledger` binary.

---

## What This Skill Does

- Executes arbitrary `hledger` subcommands
- Returns stdout and stderr output
- Allows querying balances, registers, reports, and journal data
- Enables automation of personal finance workflows inside OpenClaw

---

## Example Usage

Input to the skill:

balance

Result:

Displays account balances from the default journal file.

Input:

register Assets

Result:

Displays register entries for the Assets account.

Input:

balance -f myledger.journal

Result:

Runs hledger against a specific ledger file.

---

## Requirements

- `hledger` must be installed and available in PATH
- The user must have read access to their ledger files

Test installation with:

hledger --version

---

## Security Notes

This skill executes shell commands using the local `hledger` binary.
It does not allow arbitrary shell execution — only `hledger` commands
are prefixed and executed.

---

## Intended Use

- Personal finance automation
- Ledger querying via chat
- Integration with Telegram or WhatsApp bots powered by OpenClaw
- Financial reporting pipelines

---

## Version

1.0.0