Cli n'importe quoi firefly iii

--- name: "cli-anything-firefly-iii" description: "Firefly III CLI - Personal finance management via CLI-Anything" version: "2.0.0" author: "CLI-Anything Community" --- # Firefly III CLI Firefly III command-line interface based on CLI-Anything specification. Converts MCP mode to stateless CLI mode to avoid Node residual process issues. ## Installation ``bash pip install cli-anything-firefly-iii ` ## Prerequisites - Python 3.10+ - Running Firefly III instance - Personal Access Token (PAT) ## Configuration ### Environment Variables (Recommended) `bash export FIREFLY_III_BASE_URL="https://firefly.yourdomain.com" export FIREFLY_III_PAT="your-personal-access-token" ` ### Command Line Arguments `bash cli-anything-firefly-iii --base-url https://firefly.yourdomain.com --pat your-token ` ## Command Groups | Command Group | Description | Corresponding API | |--------------|-------------|-------------------| | accounts | Account management (CRUD) | /api/v1/accounts | | transactions | Transaction management (CRUD) | /api/v1/transactions | | budgets | Budget management (CRUD + limits) | /api/v1/budgets | | categories | Category management (CRUD) | /api/v1/categories | | tags | Tag management (CRUD) | /api/v1/tags | | bills | Bill management (CRUD) | /api/v1/bills | | piggy-banks | Piggy bank management (CRUD + events) | /api/v1/piggy-banks | | autocomplete | Autocomplete for various entities | /api/v1/autocomplete/* | | currencies | Currency management (CRUD) | /api/v1/currencies | | recurrences | Recurring transaction management (CRUD) | /api/v1/recurrences | | rules | Rule management (CRUD + test/execute) | /api/v1/rules | | rule-groups | Rule group management (CRUD + execute) | /api/v1/rule-groups | | summary | Financial summaries | /api/v1/summary/* | | webhooks | Webhook management (CRUD + trigger) | /api/v1/webhooks | | insights | Insights and reports | /api/v1/insight/* | | search | Search | /api/v1/search/* | | export | Data export | /api/v1/data/export/* | | info | System information | /api/v1/about | ## Usage Examples ### Account Management `bash # List all accounts cli-anything-firefly-iii --json accounts list # List asset accounts cli-anything-firefly-iii --json accounts list --type asset # Get account details cli-anything-firefly-iii --json accounts get --id 123 # Create account cli-anything-firefly-iii --json accounts create --name "Cash" --type asset --currency-code USD # Update account cli-anything-firefly-iii --json accounts update --id 123 --name "New Name" # Delete account cli-anything-firefly-iii accounts delete --id 123 ` ### Transaction Management `bash # List transactions cli-anything-firefly-iii --json transactions list --limit 10 # List transactions with date range cli-anything-firefly-iii --json transactions list --start 2024-01-01 --end 2024-01-31 # Create transaction cli-anything-firefly-iii --json transactions create \ --description "Grocery" \ --amount 50.00 \ --source-account 1 \ --category "Food" # Update transaction cli-anything-firefly-iii --json transactions update --id 456 --description "Updated" # Delete transaction cli-anything-firefly-iii transactions delete --id 456 ` ### Budget Management `bash # List budgets cli-anything-firefly-iii --json budgets list # Get budget details cli-anything-firefly-iii --json budgets get --id 1 # Create budget cli-anything-firefly-iii --json budgets create --name "Monthly Budget" # Update budget cli-anything-firefly-iii --json budgets update --id 1 --name "New Budget Name" # Delete budget cli-anything-firefly-iii budgets delete --id 1 # List budget limits cli-anything-firefly-iii --json budgets limits --budget-id 1 # Create budget limit cli-anything-firefly-iii --json budgets limit-create --budget-id 1 --amount 1000 --start 2024-01-01 --end 2024-01-31 # Update budget limit cli-anything-firefly-iii --json budgets limit-update --id 1 --amount 1500 # Delete budget limit cli-anything-firefly-iii budgets limit-delete --id 1 ` ### Category Management `bash # List categories cli-anything-firefly-iii --json categories list # Get category cli-anything-firefly-iii --json categories get --id 1 # Create category cli-anything-firefly-iii --json categories create --name "Food" # Update category cli-anything-firefly-iii --json categories update --id 1 --name "Food & Dining" # Delete category cli-anything-firefly-iii categories delete --id 1 ` ### Tag Management `bash # List tags cli-anything-firefly-iii --json tags list # Get tag cli-anything-firefly-iii --json tags get --id "uuid-here" # Create tag cli-anything-firefly-iii --json tags create --tag "important" # Update tag cli-anything-firefly-iii --json tags update --id "uuid-here" --tag "important-updated" # Delete tag cli-anything-firefly-iii tags delete --id "uuid-here" ` ### Bill Management ``bash # List bills cli-anything-firefly-iii --json bills li