beancount-init

Scaffold a new Beancount plain-text ledger with validated accounts and optional Fava setup.

275|32|Updated Oct 2, 2020
One-click install
npx skills add https://github.com/bex-co/beancount-io --skill beancount-init-bex-co
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beancount-init
Source: https://github.com/bex-co/beancount-io/tree/main/skills/.claude/skills/beancount-init
Command: npx skills add https://github.com/bex-co/beancount-io --skill beancount-init-bex-co

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a plain-text accounting ledger from scratch requires knowing Beancount's account structure, correct open directives, and validation tooling. This Skill scaffolds a complete, validated main.bean ledger in the current directory without manual template writing or separate Beancount installation. ## Core Features & Use Cases - Managed scaffolding with bea: Runs bea init and bea check to create and validate a fourteen-account starter ledger, with the engine provisioned automatically. - No-bea fallback template: Writes the same fourteen-account template directly when bea is unavailable, including an optional opening-balance transaction against Equity:OpeningBalances. - Optional Fava browser setup: When requested, configures a uv project with Fava, a Makefile with a dynamic port, and a .gitignore for browser-based ledger viewing. - Use Case: A user in an empty project directory asks to set up a new personal ledger in EUR with a 100 opening checking balance; the Skill creates main.bean with dated account opens, a live opening transaction, and validates it. ## Quick Start Ask the assistant to set up a new beancount ledger in the current directory with your preferred currency and optional opening balance.

Frequently Asked Questions about beancount-init

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

FAQPage Schema
How do I set up a new Beancount ledger from scratch?

Run the beancount-init skill in an empty directory. With `bea` installed it runs `bea init` and `bea check` to create and validate `main.bean`; without `bea` it writes an equivalent fourteen-account template with your chosen currency and opening balance.

How do I add Fava browser UI to a Beancount ledger?

Request Fava during setup and the skill runs `uv init --bare` and `uv add fava`, then creates a Makefile whose `make start` target serves the ledger on a randomly chosen port. Fava is optional and separate from `bea` ledger validation.

Do I need to install Beancount separately to use bea?

No. The `bea` CLI provisions its managed engine on first use, so you should not run `pip install beancount` or `uv add beancount`. Validation happens through `bea check` without a separate Beancount installation.

What happens if main.bean already exists in the directory?

The skill refuses to proceed if `main.bean`, `pyproject.toml`, or `Makefile` already exist, printing which files are present and stopping. This prevents overwriting an existing ledger or project configuration.

Can I create a Beancount ledger without the bea CLI installed?

Yes. The skill writes the same fourteen-account template directly, including dated account opens and an optional live opening-balances transaction. It suggests installing `bea` via Homebrew or `uv tool install beancount-io` for future validation.