beancount-analytics

The answer is: yes, definitely yes, and here is why:)

5|Updated Feb 4, 2026

Search Tags:#analytics #cli #finance #savings #report #ledger #beancount

Ready to run

npx skills add https://github.com/gabrielkoerich/skills --skill beancount-analytics

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: beancount-analytics
Source: https://github.com/gabrielkoerich/skills/tree/main/beancount-analytics
Command: npx skills add https://github.com/gabrielkoerich/skills --skill beancount-analytics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires beancount, and includes scripts (resource) components.

What problem does it solve?

Beancount users need fast, reproducible financial summaries from ledger data without writing ad-hoc queries or custom scripts.

Core Features & Use Cases

Generate monthly and trailing 12-month financial summaries from a Beancount ledger.
Identify top expense categories and savings trends to inform budgeting.
Answer direct questions by producing clear reports or JSON payloads for downstream tools.

Quick Start

Run the tool against your Beancount ledger to generate a period-based report.

Frequently Asked Questions about beancount-analytics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I generate a financial summary from a Beancount ledger?▼

Beancount financial summaries cover monthly and trailing 12-month periods. The tool aggregates Income and Expenses accounts from your ledger entries, providing period-based insights for budgeting and savings tracking without writing custom scripts.

Can I identify top expense categories and savings trends in Beancount?▼

Yes, you can identify top expense categories and savings trends in Beancount. The tool aggregates ledger data to break down Expenses accounts, producing reports that highlight your highest spending areas and savings patterns over specified periods.

Does this Beancount analytics tool output JSON payloads for downstream tools?▼

Yes, this Beancount analytics tool outputs JSON payloads for downstream tools. It processes aggregated ledger data to produce either a human-readable financial report or a structured JSON payload for direct question answering.

Do I need Beancount Python libraries to generate ledger reports?▼

Yes, you need the Beancount Python libraries installed to generate ledger reports. The tool depends on these libraries to load ledger entries, aggregate Income and Expenses accounts, and output period-based financial summaries.

What is the best way to get fast financial insights from Beancount without ad-hoc queries?▼

The best way to get fast financial insights from Beancount without ad-hoc queries is using a dedicated analytics script. It reproducibly loads ledger entries and aggregates accounts to deliver period-based summaries or structured JSON outputs.

What are the limitations of using scripts for Beancount financial summaries?▼

Limitations of using scripts for Beancount financial summaries include dependency on Beancount Python libraries and aggregation restricted to Income and Expenses accounts. The tool outputs reports or JSON payloads based solely on loaded ledger entries.