sandogasa-hattrack(1)

📦
version 0.27.0 · 5 versions
, in fedora 43, fedora 44

🦋 sandogasa-hattrack — Sandogasa Manual, section 1 🌸

okay bestie, sit down, hydrate, and get comfy 💅 this is the sandogasa-hattrack(1) manual page and honestly? it ate. it's from the Sandogasa Manual, part 1 of 3, so don't go anywhere yet — more icon behavior is coming 🫶

💖 NAME

sandogasa-hattrack — look up a Fedora contributor's activity across services 🕵️♀️✨

🌈 SYNOPSIS

sandogasa-hattrack [--json] [--tz-source] [--color] [--working-hours]
[--no-holidays] [--refresh-holidays] [--refresh] [--now] [-h|--help]
[-V|--version] <subcommands>

✨ DESCRIPTION

Look up a Fedora contributor's activity across services 💫

like… that's it, that's the whole assignment. you hand it a person, it goes and pokes around Fedora's little ecosystem of services, and it tells you what they've been up to. main character energy for a CLI, ngl 🕵️♀️

🎀 OPTIONS

  • --json — output machine-readable JSON 🤖 perfect for when you want to pipe it into something else instead of reading it with your own two eyeballs
  • --tz-source <TZ_SOURCE> [default: auto] — where to pull tzdb's zone1970.tab from (that's the country lookup table btw). auto picks whichever is newer out of the system one and the bundled one 👑

possible values:

  • auto
  • system
  • bundled
  • --color <COLOR> [default: auto] — colorize the output 🎨. auto = TTY + NO_COLOR-aware

possible values:

  • auto: auto-detect — turns color on when you're on a TTY and NO_COLOR is unset
  • always: force colored output even when piped 💅 no shame
  • never: disable colored output entirely
  • --working-hours <WORKING_HOURS> [default: 9-18] — the working-hours range START-END in 24h local time. anything outside that window gets dimmed 😴
  • --no-holidays — skip the Nager.Date public-holiday lookup 🏖️
  • --refresh-holidays — force-refetch holiday data from Nager.Date even when there's already a cached copy sitting right there
  • --refresh — ignore the meeting listings and logs kept under the cache directory and fetch them afresh 🔄
  • --now <NOW> — override the "now" used for local-time / holiday lookups. accepts YYYY-MM-DD (which lands at midnight UTC) or a full RFC 3339 like 2026-03-17T10:00:00Z. for testing / demos 🧪
  • -h, --help — print help (see a summary with -h)
  • -V, --version — print version

👑 COMMANDS

🌺 sandogasa-hattrack bodhi

sandogasa-hattrack bodhi [--json] [--url] [--tz-source] [--color]
[--working-hours] [--no-holidays] [--refresh-holidays] [--refresh]
[--now] [-h|--help] <USERNAME>

show a contributor's recent Bodhi updates and comments 📦✨

  • --json — output machine-readable JSON 🤖
  • --url <URL> [default: https://bodhi.fedoraproject.org] — the Bodhi instance base URL
  • --tz-source <TZ_SOURCE> [default: auto] — source for tzdb's zone1970.tab (the country lookup table). auto picks whichever is newer out of system + bundled 👑

possible values:

  • auto
  • system
  • bundled
  • --color <COLOR> [default: auto] — colorize output. auto = TTY + NO_COLOR-aware

possible values:

  • auto: auto-detect — enable on a TTY when NO_COLOR is unset
  • always: force colored output even when piped 💅
  • never: disable colored output entirely
  • --working-hours <WORKING_HOURS> [default: 9-18] — working-hours range START-END (24h local). outside is dimmed 😴
  • --no-holidays — skip the Nager.Date public-holiday lookup
  • --refresh-holidays — force-refetch holiday data from Nager.Date even when a cached copy is present
  • --refresh — ignore the meeting listings and logs kept under the cache directory and fetch them afresh 🔄
  • --now <NOW> — override "now" used for local-time / holiday lookups. accepts YYYY-MM-DD (midnight UTC) or full RFC 3339 (e.g. 2026-03-17T10:00:00Z). for testing / demos 🧪
  • -h, --help — print help (see a summary with -h)
  • <USERNAME> — the Bodhi/FAS username to look up 🔍

🦋 sandogasa-hattrack bugzilla

sandogasa-hattrack bugzilla [--email] [--json] [--no-fas] [--tz-source]
[--color] [--url] [--working-hours] [--no-holidays] [--refresh-holidays]
[--refresh] [--now] [-h|--help] [USERNAME]

show a contributor's recent Bugzilla activity 🐛✨

  • --email <EMAIL> — email address(es) to search for. repeat it for more than one: --email a@x.org --email b@y.org 📧
  • --json — output machine-readable JSON 🤖
  • --no-fas — skip the FASJSON lookup and only search username@fedoraproject.org
  • --tz-source <TZ_SOURCE> [default: auto] — source for tzdb's zone1970.tab (country lookup table). auto picks the newer of system + bundled 👑

possible values:

  • auto
  • system
  • bundled
  • --color <COLOR> [default: auto] — colorize output. auto = TTY + NO_COLOR-aware

possible values:

  • auto: auto-detect — enable on a TTY when NO_COLOR is unset
  • always: force colored output even when piped 💅
  • never: disable colored output entirely
  • --url <URL> [default: https://bugzilla.redhat.com] — the Bugzilla instance base URL
  • --working-hours <WORKING_HOURS> [default: 9-18] — working-hours range START-END (24h local). outside is dimmed 😴
  • --no-holidays — skip the Nager.Date public-holiday lookup
  • --refresh-holidays — force-refetch holiday data from Nager.Date even when a cached copy is present
  • --refresh — ignore the meeting listings and logs kept under the cache directory and fetch them afresh 🔄
  • --now <NOW> — override "now" used for local-time / holiday lookups. accepts YYYY-MM-DD (midnight UTC) or full RFC 3339 (e.g. 2026-03-17T10:00:00Z). for testing / demos 🧪
  • -h, --help — print help (see a summary with -h)
  • [USERNAME] — the FAS username to look up (used to discover the email via FASJSON) 🔍

🧚 sandogasa-hattrack distgit

sandogasa-hattrack distgit [--json] [--url] [--tz-source] [--color]
[--working-hours] [--no-holidays] [--refresh-holidays] [--refresh]
[--now] [-h|--help] <USERNAME>

show a contributor's recent dist-git activity 📦🌿

  • --json — output machine-readable JSON 🤖
  • --url <URL> [default: https://src.fedoraproject.org] — the dist-git instance base URL
  • --tz-source <TZ_SOURCE> [default: auto] — source for tzdb's zone1970.tab (country lookup table). auto picks the newer of system + bundled 👑

possible values:

  • auto
  • system
  • bundled
  • --color <COLOR> [default: auto] — colorize output. auto = TTY + NO_COLOR-aware

possible values:

  • auto: auto-detect — enable on a TTY when NO_COLOR is unset
  • always: force colored output even when piped 💅
  • never: disable colored output entirely
  • --working-hours <WORKING_HOURS> [default: 9-18] — working-hours range START-END (24h local). outside is dimmed 😴
  • --no-holidays — skip the Nager.Date public-holiday lookup
  • --refresh-holidays — force-refetch holiday data from Nager.Date even when a cached copy is present
  • --refresh — ignore the meeting listings and logs kept under the cache directory and fetch them afresh 🔄
  • --now <NOW> — override "now" used for local-time / holiday lookups. accepts YYYY-MM-DD (midnight UTC) or full RFC 3339 (e.g. 2026-03-17T10:00:00Z). for testing / demos 🧪
  • -h, --help — print help (see a summary with -h)
  • <USERNAME> — the FAS/Pagure username to look up 🔍

🍓 sandogasa-hattrack discourse

sandogasa-hattrack discourse [--json] [--url] [--tz-source] [--color]
[--working-hours] [--no-holidays] [--refresh-holidays] [--refresh]
[--now] [-h|--help] <USERNAME>

show a contributor's Discourse profile and activity 💬✨

  • --json — output machine-readable JSON 🤖
  • --url <URL> [default: https://discussion.fedoraproject.org] — the Discourse instance base URL
  • --tz-source <TZ_SOURCE> [default: auto] — source for tzdb's zone1970.tab (country lookup table). auto picks the newer of system + bundled 👑

possible values:

  • auto
  • system
  • bundled
  • --color <COLOR> [default: auto] — colorize output. auto = TTY + NO_COLOR-aware

possible values:

  • auto: auto-detect — enable on a TTY when NO_COLOR is unset
  • always: force colored output even when piped 💅
  • never: disable colored output entirely
  • --working-hours <WORKING_HOURS> [default: 9-18] — working-hours range START-END (24h local). outside is dimmed 😴
  • --no-holidays — skip the Nager.Date public-holiday lookup
  • --refresh-holidays — force-refetch holiday data from Nager.Date even when a cached copy is present
  • --refresh — ignore the meeting listings and logs kept under the cache directory and fetch them afresh 🔄
  • --now <NOW> — override "now" used for local-time / holiday lookups. accepts YYYY-MM-DD (midnight UTC) or full RFC 3339 (e.g. 2026-03-17T10:00:00Z). for testing / demos 🧪
  • -h, --help — print help (see a summary with -h)
  • <USERNAME> — the Discourse username to look up 🔍

💜 sandogasa-hattrack forge

sandogasa-hattrack forge [--json] [--repo] [--days] [--tz-source]
[--color] [--url] [--working-hours] [--no-holidays] [--refresh-holidays]
[--refresh] [--now] [-h|--help] <USERNAME>

show a contributor's Forgejo activity, per repository 🛠️✨

  • --json — output machine-readable JSON 🤖
  • --repo <REPO> — only these repositories (owner/repo, e.g. fesco/tickets); repeatable. lists every event instead of a per-repo summary 📋
  • --days <DAYS> [default: 90] — how far back to look ⏳
  • --tz-source <TZ_SOURCE> [default: auto] — source for tzdb's zone1970.tab (country lookup table). auto picks the newer of system + bundled 👑

possible values:

  • auto
  • system
  • bundled
  • --color <COLOR> [default: auto] — colorize output. auto = TTY + NO_COLOR-aware

possible values:

  • auto: auto-detect — enable on a TTY when NO_COLOR is unset
  • always: force colored output even when piped 💅
  • never: disable colored output entirely
  • --url <URL> [default: https://forge.fedoraproject.org] — the Forgejo instance base URL
  • --working-hours <WORKING_HOURS> [default: 9-18] — working-hours range START-END (24h local). outside is dimmed 😴
  • --no-holidays — skip the Nager.Date public-holiday lookup
  • --refresh-holidays — force-refetch holiday data from Nager.Date even when a cached copy is present
  • --refresh — ignore the meeting listings and logs kept under the cache directory and fetch them afresh 🔄
  • --now <NOW> — this is your lil time machine bestie ⏰✨ it overrides the "now" that gets used for local-time and holiday lookups. Hand it a YYYY-MM-DD (that means midnight UTC, okay?) or a whole full RFC 3339 stamp like 2026-03-17T10:00:00Z. For testing / demos 💅
  • -h, --help — prints the help. The short -h one gives you just a summary, the long one gives you everything 👑
  • <USERNAME> — the Forgejo username you're looking up, periodt 🦋

🌸 sandogasa-hattrack group 🌸

sandogasa-hattrack group [--json] [--max-members] [--skip] [--tz-source]
[--color] [--only] [--meeting] [--working-hours] [--no-holidays]
[--repo] [--refresh-holidays] [--refresh] [--now] [-h|--help] <GROUP>

Last activity of every single member of a FAS group, most recent first. Literally a whole roster, ranked by who touched grass last 🔥

  • --json — Output machine-readable JSON
  • --max-members <N> (default: 25) — it will straight up refuse a group that has more members than this, because every single member costs you a round of service queries 😭 Raise it on purpose, not by accident.
  • --skip <SKIP> (default: mailman) — skip these services (comma-separated, repeatable). Mailman gets skipped unless you ask for it, because its archive walk per member would dominate the entire run 💀

Possible values:

  • bodhi
  • bugzilla
  • discourse
  • distgit
  • forge
  • mailman
  • meetings — Only with --meeting
  • --tz-source <TZ_SOURCE> (default: auto) — where to pull tzdb's zone1970.tab (that's the country lookup table) from. auto picks whichever is newer out of system + bundled 🌍

Possible values:

  • auto
  • system
  • bundled
  • --color <COLOR> (default: auto) — colorize the output. auto = TTY + NO_COLOR-aware 🎨

Possible values:

  • auto — Auto-detect: enable on a TTY when NO_COLOR is unset
  • always — Force colored output even when piped
  • never — Disable colored output entirely
  • --only <ONLY> — run only these services (comma-separated, repeatable). Inverse vibe of skipping ✨

Possible values:

  • bodhi
  • bugzilla
  • discourse
  • distgit
  • forge
  • mailman
  • meetings — Only with --meeting
  • --meeting <TOPIC> — also report each member's last attended meetbot meeting with this topic (e.g. fesco) 👯
  • --working-hours <WORKING_HOURS> (default: 9-18) — the working-hours range START-END, in 24h local time. Anything outside it gets dimmed 🌙
  • --no-holidays — skip the Nager.Date public-holiday lookup 🎀
  • --repo <OWNER/REPO> — count Forgejo activity in these repositories only (owner/repo); repeatable 📁
  • --refresh-holidays — force-refetch holiday data from Nager.Date even when there's already a cached copy sitting right there 🌴
  • --refresh — ignore the meeting listings and logs kept under the cache directory and fetch them afresh, no cap 🔄
  • --now <NOW> — override the "now" used for local-time / holiday lookups. Takes YYYY-MM-DD (midnight UTC) or a full RFC 3339 (e.g. 2026-03-17T10:00:00Z). For testing / demos 💫
  • -h, --help — Print help (see a summary with '-h')
  • <GROUP> — the FAS group name (e.g. rust-sig) 💜

🫶 sandogasa-hattrack last-seen 🫶

sandogasa-hattrack last-seen [--email] [--json] [--no-fas] [--tz-source]
[--color] [--list] [--max-pages] [--working-hours] [--no-holidays]
[--skip] [--only] [--refresh-holidays] [--meeting] [--refresh] [--now]
[--repo] [--matrix] [-h|--help] <USERNAME>

A whole summary of a contributor's last activity across every service. The "where has this person been" report 🕵️♀️

  • --email <EMAIL> — email address(es) for Bugzilla/Mailman. Repeat it for multiple: --email a@x.org --email b@y.org 📧
  • --json — Output machine-readable JSON
  • --no-fas — skip the FASJSON lookup for email discovery 🙈
  • --tz-source <TZ_SOURCE> (default: auto) — source for tzdb's zone1970.tab (country lookup table). auto picks the newer of system + bundled 🌍

Possible values:

  • auto
  • system
  • bundled
  • --color <COLOR> (default: auto) — colorize output. auto = TTY + NO_COLOR-aware 🎨

Possible values:

  • auto — Auto-detect: enable on a TTY when NO_COLOR is unset
  • always — Force colored output even when piped
  • never — Disable colored output entirely
  • --list <LIST> (default: devel@lists.fedoraproject.org) — mailing list(s) to search for the sender's ID 📬
  • --max-pages <MAX_PAGES> (default: 200) — max pages to scan through the mailing list archives 📄
  • --working-hours <WORKING_HOURS> (default: 9-18) — working-hours range START-END (24h local). Outside is dimmed 🌙
  • --no-holidays — skip the Nager.Date public-holiday lookup 🎀
  • --skip <SKIP> — skip these services (comma-separated, repeatable). Mailman is the slowest one, so --skip mailman is the common speed-up when a user doesn't post to lists 🐌💨

Possible values:

  • bodhi
  • bugzilla
  • discourse
  • distgit
  • forge
  • mailman
  • meetings — Only with --meeting
  • --only <ONLY> — run only these services (comma-separated, repeatable). The inverse of --skip 🪞

Possible values:

  • bodhi
  • bugzilla
  • discourse
  • distgit
  • forge
  • mailman
  • meetings — Only with --meeting
  • --refresh-holidays — force-refetch holiday data from Nager.Date even when a cached copy is present 🌴
  • --meeting <TOPIC> — also report the last attended meetbot meeting with this topic (e.g. fesco) 👯
  • --refresh — ignore the meeting listings and logs kept under the cache directory and fetch them afresh 🔄
  • --now <NOW> — override "now" for local-time / holiday lookups. Takes YYYY-MM-DD (midnight UTC) or a full RFC 3339 (e.g. 2026-03-17T10:00:00Z). For testing / demos 💫
  • --repo <OWNER/REPO> — count Forgejo activity in these repositories only (owner/repo, e.g. fesco/tickets); repeatable 📁
  • --matrix <MXID> — extra Matrix ID(s) that are this user in meeting minutes, beyond @<username>:fedora.im and whatever the FAS profile has; repeatable 🧚
  • -h, --help — Print help (see a summary with '-h')
  • <USERNAME> — FAS username to look up 👑

🦋 sandogasa-hattrack mailman 🦋

sandogasa-hattrack mailman [--email] [--json] [--no-fas] [--tz-source]
[--color] [--list] [--max-pages] [--working-hours] [--no-holidays]
[--refresh-holidays] [--refresh] [--now] [-h|--help] [USERNAME]

Show a contributor's mailing list activity. Just the lists, bestie, nothing else 📮

  • --email <EMAIL> — email address(es) to search for (this skips the FASJSON lookup). Repeat for multiple: --email a@x.org --email b@y.org 📧
  • --json — Output machine-readable JSON
  • --no-fas — skip the FASJSON lookup and only search username@fedoraproject.org 🙈
  • --tz-source <TZ_SOURCE> (default: auto) — source for tzdb's zone1970.tab (country lookup table). auto picks the newer of system + bundled 🌍

Possible values:

  • auto
  • system
  • bundled
  • --color <COLOR> (default: auto) — colorize output. auto = TTY + NO_COLOR-aware 🎨

Possible values:

  • auto — Auto-detect: enable on a TTY when NO_COLOR is unset
  • always — Force colored output even when piped
  • never — Disable colored output entirely
  • --list <LIST> (default: devel@lists.fedoraproject.org) — mailing list(s) to search for the sender. Repeat for multiple: --list a@x.org --list b@x.org 📬
  • --max-pages <MAX_PAGES> (default: 200) — max pages to scan when searching for the sender. Each page has ~10 emails, and high-traffic lists may need 200+ to cover a whole week 😳
  • --working-hours <WORKING_HOURS> (default: 9-18) — working-hours range START-END (24h local). Outside is dimmed 🌙
  • --no-holidays — skip the Nager.Date public-holiday lookup 🎀
  • --refresh-holidays — force-refetch holiday data from Nager.Date even when a cached copy is present 🌴
  • --refresh — ignore the meeting listings and logs kept under the cache directory and fetch them afresh 🔄
  • --now <NOW> — override "now" for local-time / holiday lookups. Takes YYYY-MM-DD (midnight UTC) or a full RFC 3339 (e.g. 2026-03-17T10:00:00Z). For testing / demos 💫
  • -h, --help — Print help (see a summary with '-h')
  • [USERNAME] — FAS username to look up (it's used to discover the email via FASJSON) 🫶

✨ sandogasa-hattrack meetings ✨

sandogasa-hattrack meetings [--json] [--meeting] [--days] [--tz-source]
[--color] [--since] [--matrix] [--working-hours] [--no-fas]
[--no-holidays] [--refresh-holidays] [--url] [--refresh] [--now]
[-h|--help] <USERNAME>

Show a contributor's attendance at a recurring meetbot meeting. Yes, we're counting who actually showed up 📋✨

  • --json — Output machine-readable JSON
  • --meeting <TOPIC> (default: fesco) — the meeting's meetbot topic (that's its !meetingname) 🗓️
  • --days <DAYS> (default: 180) — how far back to look ⏳
  • --tz-source <TZ_SOURCE> (default: auto) — source for tzdb's zone1970.tab (country lookup table). auto picks the newer of system + bundled 🌍

Possible values:

  • auto
  • system
  • bundled
  • --color <COLOR> (default: auto) — colorize output. auto = TTY + NO_COLOR-aware 🎨

Possible values:

  • auto — Auto-detect: enable on a TTY when NO_COLOR is unset
  • always — Force colored output even when piped
  • never — Disable colored output entirely
  • --since <YYYY-MM-DD> — look from this date instead of --days back — e.g. the day the member joined, so earlier meetings don't count against them 🥺 that's so fair actually
  • --matrix <MXID> — extra Matrix ID(s) that are this user, beyond @<username>:fedora.im and the FAS profile's; repeatable 🧚
  • --working-hours <WORKING_HOURS> (default: 9-18) — working-hours range START-END (24h local). Outside is dimmed 🌙
  • --no-fas — skip the FASJSON lookup of the profile's Matrix IDs 🙈
  • --no-holidays — skip the Nager.Date public-holiday lookup 🎀
  • --refresh-holidays — force-refetch holiday data from Nager.Date even when a cached copy is present 🌴
  • --url <URL> (default: https://meetbot.fedoraproject.org) — the meetbot instance base URL 🔗
  • --refresh — okay so bestie, normally we're cozy and we trust the meeting listings and logs chillin' under the cache directory. This flag says no ma'am. It ignores all of that and fetches everything afresh ✨ Use it when the cache is giving stale and you can't deal 💅
  • --now <NOW> — this one overrides the "now" that gets used for local-time / holiday lookups. It takes either YYYY-MM-DD, which it reads as midnight UTC, or a full RFC 3339 timestamp, like 2026-03-17T10:00:00Z. It's for testing / demos, so go ahead and time-travel, you icon 🕰️💖
  • -h, --help — prints the help. Note that -h gives you the short-and-sweet summary version, so if you want the whole thing, you know where to be 🫶
  • <USERNAME> — the FAS username you're looking up, fr fr. On Matrix that lands as @<username>:fedora.im, no cap 💫
🌸 tiny reminder: --now is for testing / demos — it's not a magic "make it a different day for real" button, it just changes what "now" means for those local-time / holiday lookups 🙈

aaaand that's the whole page bestie, you read all three parts, I'm so proud of you 😭👑

this was sandogasa-hattrack(1) from sandogasa version 0.27.0, dated 2026-10-21 — go be the main character of your own terminal, ily, periodt 💜🦋

📦 where this page comes from
  • fedora 43: sandogasa 0.27.0-2.fc43 · (Apache-2.0 OR MIT) AND LicenseRef-Fedora-Public-Domain AND Unicode-3.0 AND Apache-2.0 AND ISC AND MIT AND (Apache-2.0 OR BSL-1.0) AND (Apache-2.0 OR ISC OR MIT) AND (Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT) AND BSD-3-Clause AND MPL-2.0 AND (Unlicense OR MIT) AND Zlib
  • fedora 44: sandogasa 0.27.0-2.fc44 · (Apache-2.0 OR MIT) AND LicenseRef-Fedora-Public-Domain AND Unicode-3.0 AND Apache-2.0 AND ISC AND MIT AND (Apache-2.0 OR BSL-1.0) AND (Apache-2.0 OR ISC OR MIT) AND (Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT) AND BSD-3-Clause AND MPL-2.0 AND (Unlicense OR MIT) AND Zlib
  • 💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms