Communitygithub.com

cli-anything-firefly-iii

Interface en ligne de commande pour Firefly III - Gestion des finances personnelles via CLI-Anything

Qu'est-ce que cli-anything-firefly-iii ?

Firefly III CLI est un outil en ligne de commande basé sur la spécification CLI-Anything, conçu pour interagir avec l'API REST de Firefly III, un logiciel de gestion de finances personnelles. Ce skill convertit le mode MCP en mode CLI sans état pour éviter les problèmes de processus résiduels Node.js. Il offre un accès complet aux groupes de commandes CRUD et analyses financières, notamment la gestion des comptes, transactions, budgets, catégories, étiquettes, factures, tirelires, devises, récurrences, règles, webhooks, et rapports d’insights. Les utilisateurs peuvent filtrer les commandes disponibles via des préréglages (presets) comme `default`, `full`, `budget` ou `reporting`. Nécessite un accès à une instance Firefly III et un jeton d'accès personnel (PAT). L'interface produit des sorties JSON structurées, ce qui la rend idéale pour l'intégration avec des agents d'IA et des scripts automatisés.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/HKUDS/CLI-Anything/tree/main/skills/cli-anything-firefly-iii
Voir l'original→Voir toutes les compétences

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentation

Interface en ligne de commande Firefly III

Interface en ligne de commande pour Firefly III basée sur la spécification CLI-Anything. Convertit le mode MCP en mode CLI sans état pour éviter les problèmes de processus résiduels Node.js.

Installation

pip install cli-anything-firefly-iii

Prérequis

  • Python 3.10+
  • Instance Firefly III en cours d'exécution
  • Jeton d'accès personnel (PAT)

Configuration

Variables d'environnement (recommandé)

export FIREFLY_III_BASE_URL="https://firefly.yourdomain.com"
export FIREFLY_III_PAT="votre-jeton-d-acces-personnel"

Arguments de ligne de commande

cli-anything-firefly-iii --base-url https://firefly.yourdomain.com --pat votre-jeton

Groupes de commandes

Groupe de commandesDescriptionAPI correspondante
accountsGestion des comptes (CRUD)/api/v1/accounts
transactionsGestion des transactions (CRUD)/api/v1/transactions
budgetsGestion des budgets (CRUD + limites)/api/v1/budgets
categoriesGestion des catégories (CRUD)/api/v1/categories
tagsGestion des étiquettes (CRUD)/api/v1/tags
billsGestion des factures (CRUD)/api/v1/bills
piggy-banksGestion des tirelires (CRUD + événements)/api/v1/piggy-banks
autocompleteSaisie automatique pour diverses entités/api/v1/autocomplete/*
currenciesGestion des devises (CRUD)/api/v1/currencies
recurrencesGestion des transactions récurrentes (CRUD)/api/v1/recurrences
rulesGestion des règles (CRUD + test/exécution)/api/v1/rules
rule-groupsGestion des groupes de règles (CRUD + exécution)/api/v1/rule-groups
summaryRésumés financiers/api/v1/summary/*
webhooksGestion des webhooks (CRUD + déclenchement)/api/v1/webhooks
insightsInformations et rapports/api/v1/insight/*
searchRecherche/api/v1/search/*
exportExportation de données/api/v1/data/export/*
infoInformations système/api/v1/about

Exemples d'utilisation

Gestion des comptes

# Lister tous les comptes
cli-anything-firefly-iii --json accounts list

# Lister les comptes d'actifs
cli-anything-firefly-iii --json accounts list --type asset

# Obtenir les détails d'un compte
cli-anything-firefly-iii --json accounts get --id 123

# Créer un compte
cli-anything-firefly-iii --json accounts create --name "Espèces" --type asset --currency-code EUR

# Mettre à jour un compte
cli-anything-firefly-iii --json accounts update --id 123 --name "Nouveau nom"

# Supprimer un compte
cli-anything-firefly-iii accounts delete --id 123

Gestion des transactions

# Lister les transactions
cli-anything-firefly-iii --json transactions list --limit 10

# Lister les transactions avec une plage de dates
cli-anything-firefly-iii --json transactions list --start 2024-01-01 --end 2024-01-31

# Créer une transaction
cli-anything-firefly-iii --json transactions create \
  --description "Courses" \
  --amount 50.00 \
  --source-account 1 \
  --category "Alimentation"

# Mettre à jour une transaction
cli-anything-firefly-iii --json transactions update --id 456 --description "Mis à jour"

# Supprimer une transaction
cli-anything-firefly-iii transactions delete --id 456

Gestion des budgets

# Lister les budgets
cli-anything-firefly-iii --json budgets list

# Obtenir les détails d'un budget
cli-anything-firefly-iii --json budgets get --id 1

# Créer un budget
cli-anything-firefly-iii --json budgets create --name "Budget mensuel"

# Mettre à jour un budget
cli-anything-firefly-iii --json budgets update --id 1 --name "Nouveau nom de budget"

# Supprimer un budget
cli-anything-firefly-iii budgets delete --id 1

# Lister les limites d'un budget
cli-anything-firefly-iii --json budgets limits --budget-id 1

# Créer une limite de budget
cli-anything-firefly-iii --json budgets limit-create --budget-id 1 --amount 1000 --start 2024-01-01 --end 2024-01-31

# Mettre à jour une limite de budget
cli-anything-firefly-iii --json budgets limit-update --id 1 --amount 1500

# Supprimer une limite de budget
cli-anything-firefly-iii budgets limit-delete --id 1

Gestion des catégories

# Lister les catégories
cli-anything-firefly-iii --json categories list

# Obtenir une catégorie
cli-anything-firefly-iii --json categories get --id 1

# Créer une catégorie
cli-anything-firefly-iii --json categories create --name "Alimentation"

# Mettre à jour une catégorie
cli-anything-firefly-iii --json categories update --id 1 --name "Alimentation & Restaurant"

# Supprimer une catégorie
cli-anything-firefly-iii categories delete --id 1

Gestion des étiquettes

# Lister les étiquettes
cli-anything-firefly-iii --json tags list

# Obtenir une étiquette
cli-anything-firefly-iii --json tags get --id "uuid-ici"

# Créer une étiquette
cli-anything-firefly-iii --json tags create --tag "important"

# Mettre à jour une étiquette
cli-anything-firefly-iii --json tags update --id "uuid-ici" --tag "important-mis-a-jour"

# Supprimer une étiquette
cli-anything-firefly-iii tags delete --id "uuid-ici"

Gestion des factures

# Lister les factures
cli-anything-firefly-iii --json bills list

# Obtenir une facture
cli-anything-firefly-iii --json bills get --id 1

# Créer une facture
cli-anything-firefly-iii --json bills create \
  --name "Netflix" \
  --amount-min 15.99 \
  --amount-max 15.99 \
  --frequency monthly

# Mettre à jour une facture
cli-anything-firefly-iii --json bills update --id 1 --amount-min 19.99

# Supprimer une facture
cli-anything-firefly-iii bills delete --id 1

Gestion des tirelires

# Lister les tirelires
cli-anything-firefly-iii --json piggy-banks list

# Obtenir une tirelire
cli-anything-firefly-iii --json piggy-banks get --id 1

# Créer une tirelire
cli-anything-firefly-iii --json piggy-banks create \
  --name "Fonds vacances" \
  --account-id 1 \
  --target-amount 5000

# Mettre à jour une tirelire
cli-anything-firefly-iii --json piggy-banks update --id 1 --name "Nouveau nom"

# Supprimer une tirelire
cli-anything-firefly-iii piggy-banks delete --id 1

# Lister les événements d'une tirelire
cli-anything-firefly-iii --json piggy-banks events --id 1

# Ajouter de l'argent à une tirelire
cli-anything-firefly-iii --json piggy-banks add-money --id 1 --amount 100

Saisie automatique (Autocomplete)

# Saisie automatique pour les comptes
cli-anything-firefly-iii --json autocomplete accounts --query "banque"

# Saisie automatique pour les catégories
cli-anything-firefly-iii --json autocomplete categories --query "alimentation"

# Saisie automatique pour les étiquettes
cli-anything-firefly-iii --json autocomplete tags --query "important"

# Saisie automatique pour les transactions
cli-anything-firefly-iii --json autocomplete transactions --query "courses"

# Saisie automatique pour les budgets
cli-anything-firefly-iii --json autocomplete budgets --query "mensuel"

# Saisie automatique pour les factures
cli-anything-firefly-iii --json autocomplete bills --query "netflix"

# Saisie automatique pour les tirelires
cli-anything-firefly-iii --json autocomplete piggy-banks --query "vacances"

# Saisie automatique pour les devises
cli-anything-firefly-iii --json autocomplete currencies --query "dollar"

# Saisie automatique pour les règles
cli-anything-firefly-iii --json autocomplete rules --query "auto"

# Saisie automatique pour les groupes de règles
cli-anything-firefly-iii --json autocomplete rule-groups --query "finances"

# Saisie automatique pour les récurrentes
cli-anything-firefly-iii --json autocomplete recurring --query "loyer"

# Saisie automatique pour les groupes d'objets
cli-anything-firefly-iii --json autocomplete object-groups --query "groupe"

# Saisie automatique pour les types de transactions
cli-anything-firefly-iii --json autocomplete transaction-types --query "retrait"

Gestion des devises

# Lister les devises
cli-anything-firefly-iii --json currencies list

# Obtenir une devise
cli-anything-firefly-iii --json currencies get --id 1

# Créer une devise
cli-anything-firefly-iii --json currencies create \
  --code "CNY" \
  --name "Yuan chinois" \
  --symbol "¥"

# Mettre à jour une devise
cli-anything-firefly-iii --json currencies update --id 1 --symbol "元"

# Supprimer une devise
cli-anything-firefly-iii currencies delete --id 1

# Obtenir les taux de change
cli-anything-firefly-iii --json currencies exchange-rates --from USD --to EUR

Gestion des transactions récurrentes

# Lister les transactions récurrentes
cli-anything-firefly-iii --json recurrences list

# Obtenir une transaction récurrente
cli-anything-firefly-iii --json recurrences get --id 1

# Créer une transaction récurrente
cli-anything-firefly-iii --json recurrences create \
  --title "Paiement loyer" \
  --type withdrawal \
  --amount 1500 \
  --source-account 1 \
  --destination-account 2 \
  --frequency monthly

# Mettre à jour une transaction récurrente
cli-anything-firefly-iii --json recurrences update --id 1 --amount 1600

# Supprimer une transaction récurrente
cli-anything-firefly-iii recurrences delete --id 1

Gestion des règles

# Lister les règles
cli-anything-firefly-iii --json rules list

# Obtenir une règle
cli-anything-firefly-iii --json rules get --id 1

# Créer une règle
cli-anything-firefly-iii --json rules create \
  --title "Étiquetage auto des courses" \
  --trigger "description_contains" \
  --value "courses" \
  --action set_category \
  --action-value "Alimentation"

# Mettre à jour une règle
cli-anything-firefly-iii --json rules update --id 1 --title "Nouveau titre"

# Supprimer une règle
cli-anything-firefly-iii rules delete --id 1

# Tester une règle
cli-anything-firefly-iii --json rules test --id 1

# Exécuter une règle
cli-anything-firefly-iii --json rules execute --id 1

Gestion des groupes de règles

# Lister les groupes de règles
cli-anything-firefly-iii --json rule-groups list

# Obtenir un groupe de règles
cli-anything-firefly-iii --json rule-groups get --id 1

# Créer un groupe de règles
cli-anything-firefly-iii --json rule-groups create --title "Règles financières"

# Mettre à jour un groupe de règles
cli-anything-firefly-iii --json rule-groups update --id 1 --title "Nouveau titre"

# Supprimer un groupe de règles
cli-anything-firefly-iii rule-groups delete --id 1

# Exécuter un groupe de règles
cli-anything-firefly-iii --json rule-groups execute --id 1

Rapports de synthèse

# Ensemble de synthèse par défaut
cli-anything-firefly-iii --json summary default-set --start 2024-01-01 --end 2024-01-31

# Synthèse des comptes
cli-anything-firefly-iii --json summary account-summary --start 2024-01-01 --end 2024-01-31

# Synthèse des budgets disponibles
cli-anything-firefly-iii --json summary available-budget --start 2024-01-01 --end 2024-01-31

# Synthèse des factures
cli-anything-firefly-iii --json summary bill-summary --start 2024-01-01 --end 2024-01-31

# Synthèse des budgets
cli-anything-firefly-iii --json summary budget-summary --start 2024-01-01 --end 2024-01-31

# Synthèse des catégories
cli-anything-firefly-iii --json summary category-summary --start 2024-01-01 --end 2024-01-31

# Synthèse des étiquettes
cli-anything-firefly-iii --json summary tag-summary --start 2024-01-01 --end 2024-01-31

# Synthèse des transferts
cli-anything-firefly-iii --json summary transfer-summary --start 2024-01-01 --end 2024-01-31

Gestion des webhooks

# Lister les webhooks
cli-anything-firefly-iii --json webhooks list

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

# Créer un webhook
cli-anything-firefly-iii --json webhooks create \
  --title "Mon Webhook" \
  --trigger create \
  --url "https://example.com/webhook" \
  --secret "mon-secret"

# Mettre à jour un webhook
cli-anything-firefly-iii --json webhooks update --id 1 --title "Nouveau titre"

# Supprimer un webhook
cli-anything-firefly-iii webhooks delete --id 1

# Déclencher manuellement un webhook
cli-anything-firefly-iii --json webhooks trigger --id 1

Informations et rapports (Insights)

# Rapport de dépenses (par catégorie)
cli-anything-firefly-iii --json insights expense \
  --start 2024-01-01 \
  --end 2024-01-31 \
  --group-by category

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

# Informations sur les transferts
cli-anything-firefly-iii --json insights transfer \
  --start 2024-01-01 \
  --end 2024-01-31

# Aperçu des comptes
cli-anything-firefly-iii --json insights overview \
  --start 2024-01-01 \
  --end 2024-01-31

Recherche

# Rechercher dans les transactions
cli-anything-firefly-iii --json search transactions --query "courses"

Exportation de données

# Exporter les transactions
cli-anything-firefly-iii --json export transactions \
  --start 2024-01-01 \
  --end 2024-01-31

# Exporter les comptes
cli-anything-firefly-iii --json export accounts

# Exporter les budgets
cli-anything-firefly-iii --json export budgets

# Exporter les catégories
cli-anything-firefly-iii --json export categories

Informations système

# Informations système
cli-anything-firefly-iii --json info about

# État de la connexion
cli-anything-firefly-iii info status

Filtrage par préréglage (Preset)

Utilisez le paramètre --preset pour filtrer les commandes disponibles :

# Préréglage par défaut
cli-anything-firefly-iii --preset default accounts list

# Préréglage complet
cli-anything-firefly-iii --preset full accounts list

# Préréglage budget
cli-anything-firefly-iii --preset budget budgets list

# Préréglage reporting
cli-anything-firefly-iii --preset reporting insights expense --start 2024-01-01 --end 2024-01-31

Préréglages disponibles :

  • default : Fonctionnalités de base (comptes, transactions, catégories, étiquettes, factures, recherche)
  • full : Toutes les fonctionnalités
  • basic : Fonctionnalités basiques (comptes, transactions, catégories, étiquettes, recherche)
  • budget : Lié au budget (comptes, budgets, transactions, synthèse, insights)
  • reporting : Lié au reporting (comptes, transactions, catégories, insights, synthèse, recherche)
  • admin : Fonctionnalités d'administration (à propos, configuration, devises, utilisateurs, préférences)
  • automation : Automatisation (règles, récurrences, webhooks, transactions)

Directives pour l'agent

Utilisation de base

  1. Utilisez --json pour une sortie structurée : Toutes les commandes prennent en charge le drapeau --json, retournant des données au format JSON
  2. Appelez info status en premier pour vérifier la connexion : Confirmez que la connexion à Firefly III est normale avant d'exécuter des opérations
  3. Utilisez les préréglages pour réduire le nombre de commandes : Filtrez les commandes inutiles via --preset

Flux de travail courants

Consulter les soldes des comptes

# 1. Vérifier la connexion
cli-anything-firefly-iii info status

# 2. Lister les comptes d'actifs
cli-anything-firefly-iii --json accounts list --type asset

# 3. Voir les détails d'un compte (obtenir le solde)
cli-anything-firefly-iii --json accounts get --id <id_du_compte>

Enregistrer une dépense

# 1. Trouver les comptes de dépenses
cli-anything-firefly-iii --json accounts list --type expense

# 2. Créer une transaction
cli-anything-firefly-iii --json transactions create \
  --description "Courses au supermarché" \
  --amount 75.50 \
  --source-account <id_du_compte_source> \
  --destination-account <id_du_compte_destination> \
  --category "Alimentation"

Gérer les budgets

# 1. Consulter les budgets
cli-anything-firefly-iii --json budgets list

# 2. Voir les limites d'un budget
cli-anything-firefly-iii --json budgets limits --budget-id <id_du_budget>

# 3. Créer une nouvelle limite
cli-anything-firefly-iii --json budgets limit-create \
  --budget-id <id_du_budget> \
  --amount <montant> \
  --start <date_debut> \
  --end <date_fin>

Générer des rapports

# Synthèse des dépenses par catégorie
cli-anything-firefly-iii --json insights expense \
  --start <date_debut> \
  --end <date_fin> \
  --group-by category

# Synthèse des comptes
cli-anything-firefly-iii --json summary account-summary \
  --start <date_debut> \
  --end <date_fin>

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 associés

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