Problem
--count and --count-by are mutually exclusive but this isn't obvious:
skygent query arsenal-feed --count --count-by author
# Error: --count-by cannot be combined with --count.
Why this matters for agents
An agent might reasonably assume --count is a mode switch and --count-by adds grouping. The mutual exclusion is a minor friction point.
Proposed fix
Merge into a single --count [field] flag:
--count alone → total count
--count author → grouped by author
--count hashtag → grouped by hashtag
This eliminates the mutual exclusion and simplifies the API surface.
Problem
--countand--count-byare mutually exclusive but this isn't obvious:Why this matters for agents
An agent might reasonably assume
--countis a mode switch and--count-byadds grouping. The mutual exclusion is a minor friction point.Proposed fix
Merge into a single
--count [field]flag:--countalone → total count--count author→ grouped by author--count hashtag→ grouped by hashtagThis eliminates the mutual exclusion and simplifies the API surface.