← Back to Skills Marketplace
bisbeebucky

Hledger

by bisbeebucky · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
394
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install hledger
Description
Execute hledger CLI commands to query balances, registers, reports, and journals, returning structured output from local ledger files.
README (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

Usage Guidance
This skill wraps the local hledger CLI but its code uses child_process.exec with unescaped user input, which can be exploited to run arbitrary shell commands. Before installing or using it: (1) avoid running it on systems with sensitive data or where untrusted inputs could be supplied; (2) prefer a patched version that uses execFile/spawn with an argument array or a strict whitelist of allowed subcommands/flags to eliminate shell interpolation; (3) require explicit user confirmation for any inputs containing unusual characters; (4) ensure hledger is installed from a trusted source and that ledger files have appropriate read permissions; (5) if you maintain the skill, replace exec with a safer API, validate/sanitize input, or sandbox the runtime (container/VM) to limit blast radius.
Capability Analysis
Type: OpenClaw Skill Name: hledger Version: 1.0.0 The `index.js` file directly concatenates user `input` into a `child_process.exec` call without any sanitization, leading to a critical shell injection vulnerability. This allows arbitrary command execution on the host system, despite the `SKILL.md` documentation claiming that the skill 'does not allow arbitrary shell execution'. This is a severe vulnerability, not intentional malice.
Capability Assessment
ℹ Purpose & Capability
The name/description match the implementation: the skill wraps the local hledger CLI. Minor metadata mismatch: registry metadata lists no required binaries whereas SKILL.md correctly notes that an hledger binary must be present in PATH.
⚠ Instruction Scope
SKILL.md states the skill 'does not allow arbitrary shell execution — only hledger commands are prefixed and executed', but the runtime instructions (index.js) use child_process.exec with a single interpolated string (`hledger ${input}`), which permits shell metacharacter injection (e.g., `;`, `&&`, backticks). That contradicts the security claim and allows execution of arbitrary shell commands if a malicious or malformed input is passed.
✓ Install Mechanism
No install spec is provided (instruction-only style with a small index.js). Nothing is downloaded or written during install, which minimizes install-time risk.
✓ Credentials
No environment variables, credentials, or config paths are requested. The skill does require the hledger binary and read access to local ledger files, which is appropriate for its purpose.
✓ Persistence & Privilege
The skill is not marked always:true and does not request elevated persistence or modify other skills. It can be invoked autonomously (default), which combined with the injection risk increases potential impact but is not a mis-declaration by itself.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install hledger
  3. After installation, invoke the skill by name or use /hledger
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
hledger skill 1.0.0 initial release: - Allows execution of `hledger` CLI commands via OpenClaw. - Returns structured stdout and stderr output from `hledger`. - Supports querying balances, registers, reports, and journal data. - Enables automation of personal finance tasks inside OpenClaw. - Ensures only `hledger` commands are executable for added security.
Metadata
Slug hledger
Version 1.0.0
License —
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Hledger?

Execute hledger CLI commands to query balances, registers, reports, and journals, returning structured output from local ledger files. It is an AI Agent Skill for Claude Code / OpenClaw, with 394 downloads so far.

How do I install Hledger?

Run "/install hledger" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Hledger free?

Yes, Hledger is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Hledger support?

Hledger is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Hledger?

It is built and maintained by bisbeebucky (@bisbeebucky); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments