Ya le entregas a tu agente de IA tu código base, tu terminal y tus sesiones de depuración más difíciles. Ahora entrégale tus libros — con cada asiento que redacte pasando por una vista previa que tú apruebas y un validador que verifica las matemáticas. La herramienta de línea de comandos bea se instala con dos comandos, funciona con archivos de libro mayor en texto plano en tu propia máquina y no necesita cuenta para la contabilidad local.
Instálala en dos comandos
Hay dos formas publicadas de obtener el mismo comando. Elige la que se ajuste a tu máquina y luego confirma que responde con su versión:
$ uv tool install beancount-io
$ brew install bex-co/tap/bea
$ bea --version
bea 0.1.0La distribución de Python es beancount-io y el ejecutable que instala es bea, actualmente en la versión 0.1.0. La ruta de uv funciona en cualquier lugar con Python 3.12 o más reciente; la ruta de Homebrew cubre macOS y Linux. La guía completa está en la página de instalación, con los mismos pasos en la guía de inicio rápido de la CLI.
La primera tarea de tu agente lleva minutos
No necesitas un agente nuevo, un complemento ni una migración de plataforma. Pega esto en el agente de IA con capacidad de shell que ya usas, en un directorio de demostración nuevo y vacío:
Tienes acceso a shell y la CLI
beainstalada. Primero ejecutabea --helpy lee lo que ofrece. Luego, en un directorio de demostración NUEVO y vacío (no toques ningún libro existente): 1) crea un libro en USD abriendo Assets:Checking con 1000 el 2026-08-01; 2) agrega una compra de 12.50 USD con la narración "Coffee" a Expenses:Dining el 2026-08-02; 3) ejecutabea check; 4) reporta el saldo de Assets:Checking junto con la consulta BQL exacta que usaste. Resultado esperado: 987.50 USD.
Los mismos pasos como comandos simples:
$ bea --no-input init demo-books --currency USD --date 2026-08-01 --opening-balance "Assets:Checking 1000"
$ cd demo-books
$ bea add transaction --date 2026-08-02 --narration "Coffee" --posting "Expenses:Dining 12.50" --posting "Assets:Checking"
$ bea check
$ bea query "SELECT account, sum(position) WHERE account = 'Assets:Checking' GROUP BY account"Resultado esperado: Assets:Checking contiene 987.50 USD — 1000 menos 12.50, validado por check y reportado con la consulta que lo calculó. Cuando tu agente te entregue ese número, habrá completado su primer ciclo cerrado: redactar, validar, reportar. La guía para agentes se basa en el mismo ciclo con dos recetas más completas — importar un CSV bancario con revisión previa, y responder una pregunta de saldo a partir de la salida de una consulta.
Lo que necesitas, y a quién va dirigido
Una terminal, una conexión de red, y ya sea Homebrew o uv con Python 3.12 o más reciente. Los comandos locales de importación, consulta, reporte y verificación no necesitan una cuenta de Beancount.io, y tus archivos de libro quedan en un directorio que elijas como texto plano que puedes comparar, respaldar y controlar por versiones.
Esto se ajusta a fundadores técnicos que llevan los libros de su propia startup, desarrolladores independientes que ya viven en una terminal, y constructores de agentes que buscan un libro contra el cual un IA pueda redactar cambios sin escrituras silenciosas. Si tus libros ya viven en un producto en la nube, la respuesta honesta es diferente — consulta la sección de comparación a continuación.
La ruta alojada es opcional y separada
Nada de lo anterior necesita una cuenta ni envía tu libro a ningún lugar. Dos extras sí lo hacen, y ambos están deliberadamente separados de instalar la CLI:
bea askresponde preguntas sobre un libro local a través del servicio de IA alojado. Necesita el extra ask —uv tool install 'beancount-io[ask]'— además de tus credenciales de Beancount.io. La instalación predeterminada omite las dependencias de IA hasta que las solicites.- El servidor MCP y los libros alojados también inician sesión con tu cuenta de Beancount.io para autorizar el acceso. Las habilidades del agente para Beancount viven en el repositorio del producto y se cargan en tu agente por separado — instalar la CLI no las instala ni configura.
Empieza local; conecta el alojamiento solo si lo quieres.
Prueba: un agente, tres filas, libros verificados
Una afirmación de lanzamiento solo es tan buena como su reproducción. Así que junto con la CLI se incluye un desafío sintético de tres filas con una respuesta derivada de aritmética antes de que cualquier reporte se ejecutara: los libros abren el 2026-09-01 con 1000 USD en cheques, el estado de cuenta lleva un pago de cliente de 2000.00 USD, una factura de hosting de −29.00 USD, y una visita a la cafetería de −12.50 USD, y las respuestas esperadas son 2958.50 USD en cheques (1000 + 2000 − 29 − 12.50) y 1958.50 USD de ganancia de septiembre (2000 − 29 − 12.50).
Un verificador de CLI instalado ejecuta todo el ciclo en un directorio temporal nuevo: la vista previa reporta 3 listos y no escribe nada, la primera aplicación escribe 3 asientos, una reimportación idéntica escribe 0 con bytes del libro preservados, una escritura desbalanceada (−5 en cheques contra +4 en comidas) sale con código 1 con bytes preservados, y check devuelve válido. Las entradas exactas se pueden descargar como main.bean, statement.csv, y rules.toml.
Luego un agente real ejecutó el mismo desafío: cliente muse 1.1.1 (Muse Code) con el modelo muse-spark-1.3-contributor, sin interfaz, 22 llamadas de herramientas, salida 0, sin intervenciones humanas — y crucialmente, sin rules.toml proporcionado, por lo que el agente derivó su propia categorización. Previsualizó 3 listos, aplicó 3 asientos, ejecutó una verificación limpia, y reportó 2958.50 USD en cheques y 1958.50 USD de ganancia de septiembre, ambos re-verificados después contra los valores esperados independientes. El registro completo — el prompt real, cada llamada de herramienta, y el único fallo real que diagnosticó por sí mismo (un bloqueo de caché en sandbox, corregido apuntando XDG_CACHE_HOME dentro del directorio de trabajo) — está publicado como la ejecución registrada, con la transcripción cruda junto a él.
La sesión de terminal a continuación es una reproducción determinista de la ruta de trabajo de esa ejecución, reconstruida a partir de las descargas canónicas por demo-replay.sh — re-enactúa los comandos, por lo que incrusta las reglas de categorización para determinismo en lugar de re-derivarlas. La salida capturada en demo-replay.txt lleva la misma información que verla:
$ bea --version
bea 0.1.0
$ bea import (preview)
csv → Assets:Checking: 3 ready, 0 exact duplicates, 0 possible duplicates
$ bea import --apply
Wrote 3 entries to $WORK/books/main.bean.
$ bea check
$WORK/books/main.bean: no errors
$ bea balance Assets:Checking
Checking 2,958.50 USD
$ bea report income-statement -t 2026-09
Net Profit: 1,958.50 USD
checking: 2958.50 USD (expected)
profit: 1958.50 USD (expected)
REPLAY OK: preview 3/0, applied 3, check clean, 2958.50 / 1958.50 USD.Dos límites honestos acompañan esta evidencia. Es verificación de salida de CLI de una sola ejecución de un cliente en datos sintéticos — no un benchmark de modelos, y no afirma nada sobre otros clientes o uso de producción desatendido. Y un check que pasa prueba que el libro cuadra, nunca que el agente eligió la cuenta correcta para la cafetería: el juicio de categorización es del agente, la validación estructural es de bea. Un juguete de tres filas prueba el ciclo, no el juicio.
Elegir entre herramientas
Si estás eligiendo un libro para flujos de trabajo de agentes en lugar de estar convencido de este, lee la comparación de cinco herramientas: Beancount.io, Xero, QuickBooks Online, Puzzle y hledger evaluados con los mismos siete criterios de flujo de trabajo de agentes — instalación, autenticación, alcance de lectura/escritura, datos locales versus nube, vista previa y validación, salida estructurada, y comportamiento de importación repetida — con fuentes oficiales fechadas verificadas el 2026-09-10. Beancount.io es la única herramienta allí con una ejecución de extremo a extremo observada detrás; la página lo dice, nombra a su editor, y etiqueta lo que no probó.
Dónde ir desde aquí
- Página de instalación — los dos comandos, la primera tarea y las descargas del desafío en un solo lugar.
- Guía de inicio rápido de la CLI — instalación más el ejemplo resuelto de 987.50 USD.
- Guía para agentes — dos recetas: importación CSV con revisión previa, y preguntas de saldo a partir de la salida de consultas.
- Ejecución registrada — la historia de prueba completa con metodología, fallos y límites.
- Comparación de cinco herramientas — qué herramienta se ajusta a qué flujo de trabajo de agentes.
Simplifica tu gestión financiera
La forma más rápida de juzgar todo esto es la demostración anterior: instala bea, pega la tarea en el agente que ya usas, y verifica los 987.50 USD tú mismo. Beancount.io proporciona contabilidad en texto plano que mantiene cada saldo reproducible y cada cambio revisable — sin cajas negras, sin dependencia del proveedor. Dale a tu agente su primer libro y mira lo que te devuelve.
