¿Qué hace finance-ledger?
Habilidad de agente de IA para registrar gastos diarios y resúmenes financieros mensuales en una bóveda de Obsidian.
Descripción
Esta habilidad permite a un agente de IA registrar transacciones diarias (gastos e ingresos) y generar resúmenes financieros mensuales directamente en una bóveda de Obsidian. Los datos se almacenan en archivos Markdown organizados por fecha, facilitando la consulta y el análisis posterior.
Características
- Registro de gastos diarios con categoría, monto y descripción.
- Generación automática de resúmenes mensuales (totales por categoría, balance).
- Integración con Obsidian para visualización y edición manual.
- Soporte para múltiples monedas (configurable).
Cómo funciona
- El agente recibe un comando o instrucción para registrar un gasto.
- El agente crea o actualiza un archivo Markdown en la carpeta
Finanzas/Gastos/YYYY/MM/con el formatoYYYY-MM-DD.md. - Cada gasto se añade como una línea en una tabla Markdown con columnas:
Fecha,Categoría,Monto,Descripción. - Al final del mes, el agente genera un resumen en
Finanzas/Resúmenes/YYYY/MM.mdcon totales y gráficos simples.
Requisitos
- Bóveda de Obsidian con acceso de lectura/escritura.
- El agente debe tener permisos para crear archivos y carpetas dentro de la bóveda.
Ejemplo de uso
<!-- El usuario dice: "Gasté 50 euros en comida hoy" -->
El agente añade la siguiente línea al archivo `Finanzas/Gastos/2025/03/2025-03-21.md`:
| 2025-03-21 | Comida | 50.00 EUR | Almuerzo con colegas |
Configuración
Define las siguientes variables de entorno o parámetros en el agente:
OBSIDIAN_VAULT_PATH: Ruta a la bóveda de Obsidian.FINANCE_CATEGORIES: Lista de categorías separadas por comas (ej.Comida,Transporte,Ocio,Facturas).FINANCE_CURRENCY: Moneda por defecto (ej.EUR,USD).
Notas
- Asegúrate de que la estructura de carpetas exista antes de usar la habilidad, o el agente la creará automáticamente.
- Los resúmenes mensuales se generan bajo demanda o al final del mes, dependiendo de la configuración.