Skip to main content

mr groups timeline

Display a timeline of Group creation and update activity as an ASCII bar chart. Each bucket is a time span (yearly, monthly, or weekly, controlled by --granularity), and each bucket prints two bars, for Groups created in it and for Groups updated, both scaled against the largest count on the chart.

The chart is anchored at the --anchor date (default: today) and shows --columns buckets backward from the anchor. The groups list filter flags apply the same way to the timeline aggregation, with one exception: --mrql is not available here. Pass the global --json flag to get the raw bucket data for scripting: the top-level response has a buckets array and a hasMore object with left and right booleans.

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 ({left, right} booleans)

Exit Codes

0 on success; 1 on any error

See Also