Skip to content

Merge --count and --count-by into a single flag #205

@mepuka

Description

@mepuka

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent-uxAgent/AI consumer experience improvementscliCLI interfacequeryQuery system

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions