Skip to main content

mr notes timeline

Display a timeline of Note 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 Notes created in that bucket.

The chart is anchored at the --anchor date (default: today) and shows --columns buckets backward from the anchor (default 15, max 60). All note-list filter flags (--name, --tags, --groups, --owner-id, --note-type-id) apply the same way to the timeline aggregation. Pass the global --json flag to get the raw bucket data for scripting.

Usage

mr notes timeline

Examples

Monthly timeline anchored at today (default)

mr notes timeline

Weekly granularity

mr notes timeline --granularity weekly --columns 12

Yearly timeline filtered by tag

mr notes timeline --granularity yearly --tags 5 --json

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
--note-type-iduint0Filter by note type ID
--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})

Exit Codes

0 on success; 1 on any error

See Also