aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-06-30 13:07:06 +0200
committerDanilo M. <danix@danix.xyz>2026-06-30 13:07:06 +0200
commit93dbbe18e934d87ebf6ae6c614bb26f0e9e5afa5 (patch)
tree73770fb498e16103528bdd350d9159d3ead170aa /README.md
parent2db11aa5d34766e4d23ccc308c57c470b6aa6dba (diff)
downloadfirefly-cli-93dbbe18e934d87ebf6ae6c614bb26f0e9e5afa5.tar.gz
firefly-cli-93dbbe18e934d87ebf6ae6c614bb26f0e9e5afa5.zip
account create: add verb for asset/expense/revenue accountsHEADv0.2.0master
New `firefly account create <name> --type asset|expense|revenue` [--opening-balance N] [--currency CODE]. asset accounts default to the defaultAsset role; opening balance is dated today (Firefly pairs the two). Unsupported types (liability, etc.) are a hard client-side error with no API call. Live-verified against the test instance. Bumps to 0.2.0. Docs synced: README, CLAUDE.md, SKILL.md, including the category/tag auto-create clarification. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Diffstat (limited to 'README.md')
-rw-r--r--README.md10
1 files changed, 7 insertions, 3 deletions
diff --git a/README.md b/README.md
index 36af8c7..c63bad9 100644
--- a/README.md
+++ b/README.md
@@ -31,6 +31,8 @@ firefly auth test verify connectivity and token
firefly account list [--type T] list accounts (filter: asset, expense, ...)
firefly account get <name|id> show one account
firefly account balance <name> show an account balance
+firefly account create <name> --type asset|expense|revenue
+ [--opening-balance N] [--currency CODE]
firefly tx add <amount> --from <acct> --to <acct> [--desc T]
[--date YYYY-MM-DD] [--category C] [--tags a,b] [--type T]
@@ -49,9 +51,11 @@ The command set grows over time; see `CLAUDE.md` for how to add one.
- Output is JSON by default. Pass `--human` for aligned tables.
- Exit code is 0 on success, 1 on any error; errors print as
`{"error": "..."}` on stderr.
-- Account, category, and tag arguments accept names, which are resolved to IDs.
- An ambiguous or unknown name is a hard error listing the candidates, never a
- silent guess.
+- Account arguments accept names, which are resolved to IDs. An ambiguous or
+ unknown account is a hard error listing the candidates, never a silent guess.
+- Categories and tags are not resolved: `tx add --category`/`--tags` pass the
+ names straight to Firefly, which creates them if new. Accounts are never
+ auto-created; use `account create`.
- `tx add` infers the transaction type from the account types (asset to expense
is a withdrawal, revenue to asset is a deposit, asset to asset is a transfer).
Override with `--type`.