summaryrefslogtreecommitdiffstats
path: root/SKILL.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-07-05 19:17:04 +0200
committerDanilo M. <danix@danix.xyz>2026-07-05 19:17:04 +0200
commit50cb852130986249cacec411e23392a8610e12f1 (patch)
treed49c544811f3f088b966046c859412f1b1015162 /SKILL.md
parent2f768bb3373105e96d0cbc6fb4ba37c777bbca25 (diff)
downloadfirefly-cli-1ff1c59c88be5288f0c861647eb93ece9b2ccc5b.tar.gz
firefly-cli-1ff1c59c88be5288f0c861647eb93ece9b2ccc5b.zip
feat(budget): tx edit --budget and budget update (v0.5.0)HEADv0.5.0master
Add two deferred budget follow-ups: - tx edit --budget: re-assign a budget on an existing transaction, mirroring the existing tx add --budget flag (name/id resolved, hard error on miss). Resolves the ISSUES.md backfill wish. - budget update: rename a budget and/or edit its auto-budget fields via PUT /budgets/{id}; only fields passed are sent, empty is a hard error. New command adds to the CLI surface without breaking callers, so this is a MINOR bump (0.4.1 -> 0.5.0). Docs (README, SKILL.md), completion, and TODO synced. The tx add --budget-id item stays open (still YAGNI). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Diffstat (limited to 'SKILL.md')
-rw-r--r--SKILL.md11
1 files changed, 8 insertions, 3 deletions
diff --git a/SKILL.md b/SKILL.md
index b3ead3d..87dcc94 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -65,7 +65,7 @@ firefly tx add <amount> (--from <acct> | --from-id <id>) (--to <acct> | --to-id
[--budget <name|id>] [--dry-run] [--skip-dupes]
firefly tx edit <id>
[--amount N] [--date YYYY-MM-DD] [--desc TEXT] [--from <acct>] [--to <acct>]
- [--category NAME] [--tags a,b] [--type T] # only fields passed are changed
+ [--category NAME] [--tags a,b] [--budget <name|id>] [--type T] # only fields passed are changed
firefly tx delete <id> --yes # --yes required, no prompt
firefly tx list [--since YYYY-MM-DD] [--until YYYY-MM-DD] [--account NAME] [--limit N] [--all]
firefly tx get <id>
@@ -75,6 +75,8 @@ firefly tag list
firefly budget list [--start YYYY-MM-DD] [--end YYYY-MM-DD] # default: current month
firefly budget create <name> [--active|--inactive]
[--auto-budget-amount N --auto-budget-period P --auto-budget-type T] [--currency CODE]
+firefly budget update <name|id> [--name NEW]
+ [--auto-budget-amount N --auto-budget-period P --auto-budget-type T] [--currency CODE]
firefly budget enable <name|id>
firefly budget disable <name|id>
firefly budget delete <name|id> --yes # --yes required, no prompt
@@ -153,13 +155,16 @@ firefly budget limit-set Groceries --amount 400 # cap for the current mon
firefly budget list # each budget + spent this month
firefly budget list --start 2026-05-01 --end 2026-05-31 # spent in a chosen period
firefly tx add 42.50 --from test01 --to Supermarket --budget Groceries
+firefly tx edit 75 --budget Groceries # (re)budget an existing tx
+firefly budget update Groceries --name Food # rename a budget
firefly budget limit-list Groceries # existing caps for a budget
firefly budget disable Groceries # stop budgeting it (toggle active)
```
`budget list` and `budget limit-set` default to the current calendar month when
`--start`/`--end` are omitted. `budget delete <ref> --yes` removes a budget
-(the `--yes` guard mirrors `tx delete`). Note the leaf names are hyphenated
-(`limit-list`, `limit-set`), not `limit list`.
+(the `--yes` guard mirrors `tx delete`). `budget update` patches only the
+fields you pass (rename via `--name`, or edit the auto-budget fields). Note the
+leaf names are hyphenated (`limit-list`, `limit-set`), not `limit list`.
**Check a balance:**
```bash