firefly-transaction

Register Firefly III transactions using a Nomad-retrieved API token via curl.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/chiyonn/dotfiles --skill firefly-transaction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: firefly-transaction
Source: https://github.com/chiyonn/dotfiles/tree/main/dot_claude/skills/firefly-transaction
Command: npx skills add https://github.com/chiyonn/dotfiles --skill firefly-transaction

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates recording transactions in Firefly III by retrieving an API token from Nomad variables and guiding the user to confirm transaction details before posting.

Core Features & Use Cases

  • Automated transaction creation in Firefly III (withdrawals, deposits, transfers)
  • Interactive confirmation of amount, date, category, source, destination, and description
  • Nomad integration: reads API tokens from Nomad variables and updates the Firefly ledger

Quick Start

Use the firefly-transaction skill to register a new transaction in Firefly III by providing amount, date, category, source, destination, and description. The token is retrieved from Nomad variables and the API call is made with curl to the Firefly III instance.

Frequently Asked Questions about firefly-transaction

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate transaction entry in Firefly III using Nomad variables?

Automate transaction entry in Firefly III by retrieving an API token from Nomad variables and posting validated entries via curl. You provide the transaction amount, date, category, source, destination, and description to register withdrawals, deposits, or transfers.

Do I need Nomad CLI and curl to record Firefly III transactions?

Yes, you need Nomad CLI and curl to record Firefly III transactions. The workflow requires the Nomad CLI to retrieve the API token from variables and curl to post the validated transaction payload to your Firefly III instance.

Can I log deposits and transfers to Firefly III, or only withdrawals?

You can log deposits and transfers to Firefly III in addition to withdrawals. The skill validates and posts all three transaction types by capturing the amount, date, category, source account, destination account, and description.

How does interactive confirmation work before posting a Firefly III transaction?

Interactive confirmation prompts you to verify the amount, date, category, source, destination, and description before posting the Firefly III transaction. This validation step ensures the curl API request contains accurate ledger data.

What is the best way to integrate personal finance automation with Nomad and Firefly III?

The best way to integrate personal finance automation with Nomad and Firefly III is using a skill that reads your API token from Nomad variables and posts validated transaction entries via curl, automating withdrawals, deposits, and transfers.

Are there limitations when using Nomad variables to store Firefly III API tokens?

A key limitation is that the Firefly III instance must be accessible with a valid API token stored in Nomad variables. If the Nomad CLI cannot retrieve the token or curl cannot reach the Firefly III endpoint, transaction posting will fail.