summaryrefslogtreecommitdiffstats
path: root/SKILL.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-07-01 10:18:39 +0200
committerDanilo M. <danix@danix.xyz>2026-07-01 10:18:39 +0200
commit0c9939c5961a3cef50e6378c0eefbeaae00f4c67 (patch)
treeca75f91cf69cf085621fd22241d4081bb118edaf /SKILL.md
parent38d7357f36e6eeb91216d1c5668fb29406c7e076 (diff)
downloadfirefly-cli-0c9939c5961a3cef50e6378c0eefbeaae00f4c67.tar.gz
firefly-cli-0c9939c5961a3cef50e6378c0eefbeaae00f4c67.zip
feat: tx list --all + truncation signal (v0.3.1)
tx list silently returned only --limit rows (default 20) with no signal when more matched, making a correct ledger look wrong during reconciliation. - --all auto-paginates every page via meta.pagination.total_pages - without --all, print "showing N of M (use --all for all)" to stderr when the result is truncated (stdout JSON stays clean) PATCH: new optional flag + stderr note, contract unchanged. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Diffstat (limited to 'SKILL.md')
-rw-r--r--SKILL.md6
1 files changed, 5 insertions, 1 deletions
diff --git a/SKILL.md b/SKILL.md
index b90ad2e..98b9472 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -61,7 +61,7 @@ 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
firefly tx delete <id> --yes # --yes required, no prompt
-firefly tx list [--since YYYY-MM-DD] [--until YYYY-MM-DD] [--account NAME] [--limit N]
+firefly tx list [--since YYYY-MM-DD] [--until YYYY-MM-DD] [--account NAME] [--limit N] [--all]
firefly tx get <id>
firefly tx search <query>
firefly category list
@@ -132,6 +132,10 @@ firefly tx delete 76 --yes # remove a duplicate
- `tx list` with no transactions in range returns `[]`. Empty is not an error;
it means no matches, not a failure.
+- `tx list` returns at most `--limit` rows (default 20). When more match, it
+ prints `showing N of M (use --all for all)` to **stderr** (stdout JSON stays
+ clean). Pass `--all` to auto-paginate every page. Critical for reconciliation:
+ a truncated list makes a correct ledger look wrong.
- Amounts are strings in responses, often with trailing zeros
(`"0.010000000000"`). Compare numerically, do not string-match.
- Dates in `tx list` filter by transaction date; omit them to use Firefly's