Skip to main content

mr groups timeline

Display a timeline of Group creation and update activity as an ASCII bar chart. Each bar represents a time bucket (yearly, monthly, or weekly, controlled by --granularity), and the bar height reflects the count of Groups created in that bucket.

The chart is anchored at the --anchor date (default: today) and shows --columns buckets backward from the anchor. All group-list filter flags (--name, --tags, --groups, --owner-id, etc.) apply the same way to the timeline aggregation. Pass the global --json flag to get the raw bucket data for scripting — the top-level response has a buckets array and a hasMore flag.

Usage

mr groups timeline

Examples

Monthly timeline anchored at today (default)

mr groups timeline

Weekly granularity

mr groups timeline --granularity weekly --columns 20

Yearly timeline anchored at 2020

mr groups timeline --granularity yearly --anchor 2020-01-01

Flags

FlagTypeDefaultDescription
--granularitystringmonthlyBucket granularity: yearly, monthly, or weekly
--anchorstring``Anchor date (YYYY-MM-DD); defaults to today
--columnsint15Number of timeline buckets (max 60)
--namestring``Filter by name
--descriptionstring``Filter by description
--tagsstring``Comma-separated tag IDs to filter by
--groupsstring``Comma-separated group IDs to filter by
--owner-iduint0Filter by owner group ID
--category-iduint0Filter by category ID
--urlstring``Filter by URL
--created-beforestring``Filter by creation date (before)
--created-afterstring``Filter by creation date (after)

Inherited global flags

FlagTypeDefaultDescription
--jsonboolfalseOutput raw JSON
--no-headerboolfalseOmit table headers
--pageint1Page number for list commands (default page size: 50)
--quietboolfalseOnly output IDs
--serverstringhttp://localhost:8181mahresources server URL (env: MAHRESOURCES_URL)

Output

Object with buckets (array of {label, start, end, created, updated}) and hasMore (bool)

Exit Codes

0 on success; 1 on any error

See Also