Communitygithub.com

cli-anything-firefly-iii

CLI de Firefly III - Gestión de finanzas personales mediante CLI-Anything

¿Qué es cli-anything-firefly-iii?

Firefly III CLI es una herramienta de línea de comandos basada en la especificación CLI-Anything que permite la gestión completa de finanzas personales a través de una instancia de Firefly III. Convierte el modo MCP en un modo CLI sin estado para evitar problemas de procesos residuales de Node, ofreciendo una interfaz robusta y ligera. Soporta operaciones CRUD completas sobre cuentas, transacciones, presupuestos, categorías, etiquetas, facturas, alcancías, monedas, recurrencias, reglas, grupos de reglas, webhooks, y además proporciona resúmenes financieros, informes de ingresos/gastos, búsqueda y exportación de datos. Se instala vía pip, requiere Python 3.10+, una instancia activa de Firefly III y un Token de Acceso Personal (PAT). Su modo `--json` permite obtener salida estructurada ideal para integración con agentes de IA.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/HKUDS/CLI-Anything/tree/main/skills/cli-anything-firefly-iii
Ver original→Ver todas las habilidades

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentación

Firefly III CLI

Interfaz de línea de comandos de Firefly III basada en la especificación CLI-Anything. Convierte el modo MCP a un modo CLI sin estado para evitar problemas de procesos residuales de Node.

Instalación

pip install cli-anything-firefly-iii

Prerrequisitos

  • Python 3.10+
  • Instancia de Firefly III en ejecución
  • Token de Acceso Personal (PAT)

Configuración

Variables de entorno (Recomendado)

export FIREFLY_III_BASE_URL="https://firefly.yourdomain.com"
export FIREFLY_III_PAT="su-token-de-acceso-personal"

Argumentos de línea de comandos

cli-anything-firefly-iii --base-url https://firefly.yourdomain.com --pat su-token

Grupos de comandos

Grupo de comandosDescripciónAPI correspondiente
accountsGestión de cuentas (CRUD)/api/v1/accounts
transactionsGestión de transacciones (CRUD)/api/v1/transactions
budgetsGestión de presupuestos (CRUD + límites)/api/v1/budgets
categoriesGestión de categorías (CRUD)/api/v1/categories
tagsGestión de etiquetas (CRUD)/api/v1/tags
billsGestión de facturas (CRUD)/api/v1/bills
piggy-banksGestión de alcancías (CRUD + eventos)/api/v1/piggy-banks
autocompleteAutocompletado para varias entidades/api/v1/autocomplete/*
currenciesGestión de monedas (CRUD)/api/v1/currencies
recurrencesGestión de transacciones recurrentes (CRUD)/api/v1/recurrences
rulesGestión de reglas (CRUD + prueba/ejecución)/api/v1/rules
rule-groupsGestión de grupos de reglas (CRUD + ejecución)/api/v1/rule-groups
summaryResúmenes financieros/api/v1/summary/*
webhooksGestión de webhooks (CRUD + disparo)/api/v1/webhooks
insightsInformación y reportes/api/v1/insight/*
searchBúsqueda/api/v1/search/*
exportExportación de datos/api/v1/data/export/*
infoInformación del sistema/api/v1/about

Ejemplos de uso

Gestión de cuentas

# Listar todas las cuentas
cli-anything-firefly-iii --json accounts list

# Listar cuentas de activos
cli-anything-firefly-iii --json accounts list --type asset

# Obtener detalles de una cuenta
cli-anything-firefly-iii --json accounts get --id 123

# Crear cuenta
cli-anything-firefly-iii --json accounts create --name "Efectivo" --type asset --currency-code USD

# Actualizar cuenta
cli-anything-firefly-iii --json accounts update --id 123 --name "Nuevo nombre"

# Eliminar cuenta
cli-anything-firefly-iii accounts delete --id 123

Gestión de transacciones

# Listar transacciones
cli-anything-firefly-iii --json transactions list --limit 10

# Listar transacciones por rango de fechas
cli-anything-firefly-iii --json transactions list --start 2024-01-01 --end 2024-01-31

# Crear transacción
cli-anything-firefly-iii --json transactions create \
  --description "Supermercado" \
  --amount 50.00 \
  --source-account 1 \
  --category "Alimentación"

# Actualizar transacción
cli-anything-firefly-iii --json transactions update --id 456 --description "Actualizada"

# Eliminar transacción
cli-anything-firefly-iii transactions delete --id 456

Gestión de presupuestos

# Listar presupuestos
cli-anything-firefly-iii --json budgets list

# Obtener detalles de presupuesto
cli-anything-firefly-iii --json budgets get --id 1

# Crear presupuesto
cli-anything-firefly-iii --json budgets create --name "Presupuesto mensual"

# Actualizar presupuesto
cli-anything-firefly-iii --json budgets update --id 1 --name "Nuevo nombre de presupuesto"

# Eliminar presupuesto
cli-anything-firefly-iii budgets delete --id 1

# Listar límites de presupuesto
cli-anything-firefly-iii --json budgets limits --budget-id 1

# Crear límite de presupuesto
cli-anything-firefly-iii --json budgets limit-create --budget-id 1 --amount 1000 --start 2024-01-01 --end 2024-01-31

# Actualizar límite de presupuesto
cli-anything-firefly-iii --json budgets limit-update --id 1 --amount 1500

# Eliminar límite de presupuesto
cli-anything-firefly-iii budgets limit-delete --id 1

Gestión de categorías

# Listar categorías
cli-anything-firefly-iii --json categories list

# Obtener categoría
cli-anything-firefly-iii --json categories get --id 1

# Crear categoría
cli-anything-firefly-iii --json categories create --name "Alimentación"

# Actualizar categoría
cli-anything-firefly-iii --json categories update --id 1 --name "Alimentación y restaurantes"

# Eliminar categoría
cli-anything-firefly-iii categories delete --id 1

Gestión de etiquetas

# Listar etiquetas
cli-anything-firefly-iii --json tags list

# Obtener etiqueta
cli-anything-firefly-iii --json tags get --id "uuid-here"

# Crear etiqueta
cli-anything-firefly-iii --json tags create --tag "importante"

# Actualizar etiqueta
cli-anything-firefly-iii --json tags update --id "uuid-here" --tag "importante-actualizado"

# Eliminar etiqueta
cli-anything-firefly-iii tags delete --id "uuid-here"

Gestión de facturas

# Listar facturas
cli-anything-firefly-iii --json bills list

# Obtener factura
cli-anything-firefly-iii --json bills get --id 1

# Crear factura
cli-anything-firefly-iii --json bills create \
  --name "Netflix" \
  --amount-min 15.99 \
  --amount-max 15.99 \
  --frequency monthly

# Actualizar factura
cli-anything-firefly-iii --json bills update --id 1 --amount-min 19.99

# Eliminar factura
cli-anything-firefly-iii bills delete --id 1

Gestión de alcancías

# Listar alcancías
cli-anything-firefly-iii --json piggy-banks list

# Obtener alcancía
cli-anything-firefly-iii --json piggy-banks get --id 1

# Crear alcancía
cli-anything-firefly-iii --json piggy-banks create \
  --name "Fondo de vacaciones" \
  --account-id 1 \
  --target-amount 5000

# Actualizar alcancía
cli-anything-firefly-iii --json piggy-banks update --id 1 --name "Nuevo nombre"

# Eliminar alcancía
cli-anything-firefly-iii piggy-banks delete --id 1

# Listar eventos de alcancía
cli-anything-firefly-iii --json piggy-banks events --id 1

# Agregar dinero a la alcancía
cli-anything-firefly-iii --json piggy-banks add-money --id 1 --amount 100

Autocompletado

# Autocompletar cuentas
cli-anything-firefly-iii --json autocomplete accounts --query "banco"

# Autocompletar categorías
cli-anything-firefly-iii --json autocomplete categories --query "alimentación"

# Autocompletar etiquetas
cli-anything-firefly-iii --json autocomplete tags --query "importante"

# Autocompletar transacciones
cli-anything-firefly-iii --json autocomplete transactions --query "supermercado"

# Autocompletar presupuestos
cli-anything-firefly-iii --json autocomplete budgets --query "mensual"

# Autocompletar facturas
cli-anything-firefly-iii --json autocomplete bills --query "netflix"

# Autocompletar alcancías
cli-anything-firefly-iii --json autocomplete piggy-banks --query "vacaciones"

# Autocompletar monedas
cli-anything-firefly-iii --json autocomplete currencies --query "dólar"

# Autocompletar reglas
cli-anything-firefly-iii --json autocomplete rules --query "auto"

# Autocompletar grupos de reglas
cli-anything-firefly-iii --json autocomplete rule-groups --query "finanzas"

# Autocompletar transacciones recurrentes
cli-anything-firefly-iii --json autocomplete recurring --query "alquiler"

# Autocompletar grupos de objetos
cli-anything-firefly-iii --json autocomplete object-groups --query "grupo"

# Autocompletar tipos de transacción
cli-anything-firefly-iii --json autocomplete transaction-types --query "retiro"

Gestión de monedas

# Listar monedas
cli-anything-firefly-iii --json currencies list

# Obtener moneda
cli-anything-firefly-iii --json currencies get --id 1

# Crear moneda
cli-anything-firefly-iii --json currencies create \
  --code "CNY" \
  --name "Yuan chino" \
  --symbol "¥"

# Actualizar moneda
cli-anything-firefly-iii --json currencies update --id 1 --symbol "元"

# Eliminar moneda
cli-anything-firefly-iii currencies delete --id 1

# Obtener tasas de cambio
cli-anything-firefly-iii --json currencies exchange-rates --from USD --to EUR

Gestión de transacciones recurrentes

# Listar transacciones recurrentes
cli-anything-firefly-iii --json recurrences list

# Obtener transacción recurrente
cli-anything-firefly-iii --json recurrences get --id 1

# Crear transacción recurrente
cli-anything-firefly-iii --json recurrences create \
  --title "Pago de alquiler" \
  --type withdrawal \
  --amount 1500 \
  --source-account 1 \
  --destination-account 2 \
  --frequency monthly

# Actualizar transacción recurrente
cli-anything-firefly-iii --json recurrences update --id 1 --amount 1600

# Eliminar transacción recurrente
cli-anything-firefly-iii recurrences delete --id 1

Gestión de reglas

# Listar reglas
cli-anything-firefly-iii --json rules list

# Obtener regla
cli-anything-firefly-iii --json rules get --id 1

# Crear regla
cli-anything-firefly-iii --json rules create \
  --title "Etiquetar automáticamente compras de supermercado" \
  --trigger "description_contains" \
  --value "supermercado" \
  --action set_category \
  --action-value "Alimentación"

# Actualizar regla
cli-anything-firefly-iii --json rules update --id 1 --title "Nuevo título"

# Eliminar regla
cli-anything-firefly-iii rules delete --id 1

# Probar regla
cli-anything-firefly-iii --json rules test --id 1

# Ejecutar regla
cli-anything-firefly-iii --json rules execute --id 1

Gestión de grupos de reglas

# Listar grupos de reglas
cli-anything-firefly-iii --json rule-groups list

# Obtener grupo de reglas
cli-anything-firefly-iii --json rule-groups get --id 1

# Crear grupo de reglas
cli-anything-firefly-iii --json rule-groups create --title "Reglas financieras"

# Actualizar grupo de reglas
cli-anything-firefly-iii --json rule-groups update --id 1 --title "Nuevo título"

# Eliminar grupo de reglas
cli-anything-firefly-iii rule-groups delete --id 1

# Ejecutar grupo de reglas
cli-anything-firefly-iii --json rule-groups execute --id 1

Reportes de resumen

# Conjunto de resumen predeterminado
cli-anything-firefly-iii --json summary default-set --start 2024-01-01 --end 2024-01-31

# Resumen de cuentas
cli-anything-firefly-iii --json summary account-summary --start 2024-01-01 --end 2024-01-31

# Resumen de presupuesto disponible
cli-anything-firefly-iii --json summary available-budget --start 2024-01-01 --end 2024-01-31

# Resumen de facturas
cli-anything-firefly-iii --json summary bill-summary --start 2024-01-01 --end 2024-01-31

# Resumen de presupuestos
cli-anything-firefly-iii --json summary budget-summary --start 2024-01-01 --end 2024-01-31

# Resumen de categorías
cli-anything-firefly-iii --json summary category-summary --start 2024-01-01 --end 2024-01-31

# Resumen de etiquetas
cli-anything-firefly-iii --json summary tag-summary --start 2024-01-01 --end 2024-01-31

# Resumen de transferencias
cli-anything-firefly-iii --json summary transfer-summary --start 2024-01-01 --end 2024-01-31

Gestión de webhooks

# Listar webhooks
cli-anything-firefly-iii --json webhooks list

# Obtener webhook
cli-anything-firefly-iii --json webhooks get --id 1

# Crear webhook
cli-anything-firefly-iii --json webhooks create \
  --title "Mi webhook" \
  --trigger create \
  --url "https://example.com/webhook" \
  --secret "mi-secreto"

# Actualizar webhook
cli-anything-firefly-iii --json webhooks update --id 1 --title "Nuevo título"

# Eliminar webhook
cli-anything-firefly-iii webhooks delete --id 1

# Disparar webhook manualmente
cli-anything-firefly-iii --json webhooks trigger --id 1

Información y reportes

# Reporte de gastos (por categoría)
cli-anything-firefly-iii --json insights expense \
  --start 2024-01-01 \
  --end 2024-01-31 \
  --group-by category

# Reporte de ingresos
cli-anything-firefly-iii --json insights income \
  --start 2024-01-01 \
  --end 2024-01-31

# Información de transferencias
cli-anything-firefly-iii --json insights transfer \
  --start 2024-01-01 \
  --end 2024-01-31

# Resumen de cuentas
cli-anything-firefly-iii --json insights overview \
  --start 2024-01-01 \
  --end 2024-01-31

Búsqueda

# Buscar transacciones
cli-anything-firefly-iii --json search transactions --query "supermercado"

Exportación de datos

# Exportar transacciones
cli-anything-firefly-iii --json export transactions \
  --start 2024-01-01 \
  --end 2024-01-31

# Exportar cuentas
cli-anything-firefly-iii --json export accounts

# Exportar presupuestos
cli-anything-firefly-iii --json export budgets

# Exportar categorías
cli-anything-firefly-iii --json export categories

Información del sistema

# Información del sistema
cli-anything-firefly-iii --json info about

# Estado de conexión
cli-anything-firefly-iii info status

Filtrado preestablecido

Use el parámetro --preset para filtrar los comandos disponibles:

# Preestablecido predeterminado
cli-anything-firefly-iii --preset default accounts list

# Preestablecido completo
cli-anything-firefly-iii --preset full accounts list

# Preestablecido de presupuesto
cli-anything-firefly-iii --preset budget budgets list

# Preestablecido de reportes
cli-anything-firefly-iii --preset reporting insights expense --start 2024-01-01 --end 2024-01-31

Preestablecidos disponibles:

  • default: Funciones principales (cuentas, transacciones, categorías, etiquetas, facturas, búsqueda)
  • full: Todas las funciones
  • basic: Funciones básicas (cuentas, transacciones, categorías, etiquetas, búsqueda)
  • budget: Relacionado con presupuestos (cuentas, presupuestos, transacciones, resumen, información)
  • reporting: Relacionado con reportes (cuentas, transacciones, categorías, información, resumen, búsqueda)
  • admin: Funciones de administración (acerca de, configuración, monedas, usuarios, preferencias)
  • automation: Automatización (reglas, recurrencias, webhooks, transacciones)

Pautas para agentes

Uso básico

  1. Use --json para salida estructurada: Todos los comandos admiten la bandera --json, que devuelve datos en formato JSON
  2. Llame a info status primero para verificar la conexión: Confirme que la conexión a Firefly III sea normal antes de ejecutar operaciones
  3. Use preestablecidos para reducir la cantidad de comandos: Filtre comandos innecesarios mediante --preset

Flujos de trabajo comunes

Ver saldos de cuentas

# 1. Verificar conexión
cli-anything-firefly-iii info status

# 2. Listar cuentas de activos
cli-anything-firefly-iii --json accounts list --type asset

# 3. Ver detalles de la cuenta (obtener saldo)
cli-anything-firefly-iii --json accounts get --id <account_id>

Registrar un gasto

# 1. Encontrar cuentas de gastos
cli-anything-firefly-iii --json accounts list --type expense

# 2. Crear transacción
cli-anything-firefly-iii --json transactions create \
  --description "Compra en supermercado" \
  --amount 50.00 \
  --source-account <cuenta_origen_id> \
  --destination-account <cuenta_destino_id> \
  --category "Alimentación"

Gestión de presupuesto

# 1. Listar presupuestos disponibles
cli-anything-firefly-iii --json budgets list

# 2. Crear un nuevo presupuesto
cli-anything-firefly-iii --json budgets create --name "Presupuesto mensual"

# 3. Establecer límite de presupuesto
cli-anything-firefly-iii --json budgets limit-create \
  --budget-id 1 \
  --amount 1000 \
  --start 2024-01-01 \
  --end 2024-01-31

Solución de problemas

Errores comunes

  1. Conexión rechazada: Verifique que la URL base de Firefly III sea correcta y que la instancia esté en ejecución
  2. Token no autorizado: Asegúrese de que el Token de Accceso Personal (PAT) tenga los permisos adecuados
  3. Comando no encontrado: Verifique la instalación y que el paquete cli-anything-firefly-iii esté correctamente instalado
  4. Error de exportación de datos: Asegúrese de que los parámetros de inicio y fin estén en formato YYYY-MM-DD

Soporte

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

cli-anything-adguardhome

>-

cli-anything-anygen

>-

cli-anything-audacity

>-

cli-anything-blender

>-

cli-anything-browser

Browser automation CLI using DOMShell MCP server. Maps Chrome

cli-anything-calibre

>-

cli-anything-ccswitch

CLI interface for CC Switch — manage AI coding tool configurations from the terminal

cli-anything-chromadb

>-

cli-anything-cloudanalyzer

Command-line interface for CloudAnalyzer — Agent-friendly harness for CloudAnalyzer, a QA platform for mapping, localization, and perception outputs. Supports 27 commands across 8 groups: point cloud evaluation, trajectory evaluation, ground segmentation QA, config-driven quality gates, baseline evolution, processing, visualization, and interactive REPL.

cli-anything-cloudcompare

Command-line interface for CloudCompare — Agent-friendly harness for CloudCompare, the open-source 3D point cloud and mesh processing software. Supports 41 commands across 9 groups: project management, session control, point cloud operations (subsample, filter, segment, analyze), mesh operations, distance computation (C2C, C2M), transformations (ICP, matrix), export (LAS/LAZ/PLY/PCD/OBJ/STL/E57), and interactive REPL.

cli-anything-comfyui

>-

cli-anything-dify-workflow

Wrapper for the Dify workflow DSL CLI. Create, inspect, validate, edit, and export Dify workflow files through a CLI-Anything harness.

cli-anything-drawio

>-

cli-anything-eez-studio

Use EEZ Studio from the command line: inspect and modify native .eez-project files, edit LVGL screens/widgets, manage SCPI commands, and invoke the real EEZ Studio backend for LVGL builds.

cli-anything-eth2-quickstart

>-

cli-anything-exa

>-

cli-anything-freecad

Complete CLI harness for FreeCAD parametric 3D CAD modeler (258 commands). Covers ALL workbenches: Part (29 primitives + boolean + mirror + loft + sweep), Sketcher (26 cmds: geometry + constraints + editing), PartDesign (38 cmds: pad/pocket/groove/fillet/chamfer/patterns/hole/datum), Assembly (11 cmds), Mesh (16 cmds), TechDraw (15 cmds: views + dimensions + PDF/SVG), Draft (33 cmds: 2D shapes + arrays + transforms), FEM (12 cmds), CAM/CNC (10 cmds), Surface (6 cmds), Spreadsheet (7 cmds), Import (13 formats), Export (17 formats), Measure (12 cmds), Materials (21 presets). Headless FreeCAD export to STEP/IGES/STL/OBJ/DXF/PDF/glTF/3MF.

cli-anything-gimp

>-

cli-anything-godot

>-

cli-anything-inkscape

>-

Skills relacionados

steipete/video-frames

Extract frames or short clips from videos using ffmpeg.

community

steipete/summarize

Summarize or transcribe URLs, YouTube/videos, podcasts, articles, transcripts, PDFs, and local files.

community

openclaw/openclaw

Use when testing, fixing, or extending the OpenClaw Control UI GUI with Vitest + Playwright end-to-end checks, mocked Gateway WebSocket flows, mocked dashboard runs, screenshots/videos, or agent-verifiable browser proof.

community

obra/superpowers

Obra superpowers agent skills.

community

affaan-m/ECC

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio...

community

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

community