Skip to content

bukio-cli v0.14.1: Initial Release

Choose a tag to compare

View all tags
@erikvankempen erikvankempen released this 09 Aug 09:33
· 159 commits to main since this release
v0.14.1
ee45f1e

bukio-cli v0.14.1: Initial Release

We are excited to announce the initial release of bukio-cli (v0.14.1), an open-source, local-first double-entry bookkeeping engine designed specifically for Dutch SMEs and AI agents.

While built for human operators, bukio-cli is architected from the ground up to be safely driven by AI agents via the Model Context Protocol (MCP). Everything runs natively on your machine or VPS against a single SQLite database file—giving you complete ownership of your financial data without vendor lock-in.

Key Features

  • Agent-Native Architecture:

    • Native MCP server integration over stdio.
    • Deterministic --json machine outputs for every command.
    • Forced --dry-run (plan mode) support for safe agent execution.
    • Append-only audit logging with required actor identity attribution (--actor human:erik or agent:bartholomeus).

  • Built for the Dutch Business Ecosystem:

    • Bidirectional E-Invoicing (Peppol BIS 3.0): Complete outgoing pipeline (finalize → compliant PDF → UBL → Peppol send) and inbound UBL import (import invoice) directly into the payables register.
    • Tax Compliance: Optional VAT module with Dutch OB-aangifte readout (fields 1a–5d), vat file balance reclassification, vat settle payment booking, KOR support, and ICP listing.
    • Statutory Reporting: Generate Jaarrekening reports (micro/klein models for Title 9 Book 2 BW) and KVK deposit packages.
    • Auditfile Compatibility: Full import and export for XML Auditfile Financieel 4.0 (XAF).

  • Core Bookkeeping & Cash Management:

    • Immutable Ledger: Double-entry engine backstopped by SQLite database triggers. Reversals create linked contra-entries; posted entries are never altered or deleted.
    • Reconciliation & Payments: CAMT.053 / CSV bank statement imports, auto-matching, payables management, and SEPA payment exports (pain.001 credit transfers and pain.008 direct debits with mandate tracking).
    • In-Database Attachments (attach): Store source PDFs or scans directly in the SQLite file as BLOBs (up to 25 MB per file, SHA-256 deduplicated).
    • Encrypted Backups: AES-256-GCM database backup encryption (backup --encrypt) with automated rotation (--keep N).
    • Fixed Assets & FX: Asset register with mid-life adoption support, lineair/degressief schemes, and live European Central Bank (ECB) rate integration for foreign currency transactions.
    • Items Catalog & Multi-Language: Product/service catalog with fractional quantities, total and line-item discounts, custom logo support, and Dutch/English invoice rendering.

Quick Start

Ensure you have Node.js >= 20 installed:

# Install globally or clone
git clone https://github.com/erikvankempen/bukio-cli.git
cd bukio-cli && npm install && npm link

# Initialize a new company database
bukio init --name "Demo BV" --kvk 12345678 --legal-form bv --vat on

# Post an initial capital entry
bukio entry add --date 2026-08-04 --desc "Startkapitaal" \
  --postings "1100:10000.00,3000:-10000.00" --post

# Check trial balance
bukio report trial-balance

Running as an MCP Server for AI Agents

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"trial_balance","arguments":{}}}' \
| bukio mcp

Documentation & Agent Guide

  • Check out AGENTS.md in the repository root for the agent integration manual, command syntax, and strict execution guardrails.
  • View the full README.md for comprehensive command references, database schema details, and cron scheduling recipes.

Feedback & Contributions

Ran into a question, bug, or anything else you need to know? Ask your agent first — it has the full agent manual (AGENTS.md) and this README in context. If your agent is unable to help, or if you want to contribute, shoot me a message at erik@posthumanresources.nl and I'll try to answer it when I'm able.

License: Apache-2.0

Assets 2
Loading