PLAKAR-QUERY(7)

💅 PLAKAR-QUERY 💅

okay bestie, welcome to plakar-query(7) from the Miscellaneous Information Manual. this is the group-chat rundown of query flags shared among many Plakar subcommands. no cap, it’s giving “filter your snapshots, but make it cute.” 🫶

✨ NAME ✨

plakar-query — query flags shared among many Plakar subcommands

🌸 DESCRIPTION 🌸

What follows is a set of command line arguments that many plakar(1) subcommands provide to filter snapshots. lowkey iconic of them, honestly.

There are two kind of flags, bestie:

• matchers — these allow you to select snapshots. If combined, the result is the union of the various matchers.
• filters — these instead filter the output of the matchers by yielding snapshots matching only certain criterias. If combined, the result is the intersection of the various filters.

If no matcher is given, all the snapshots are implicitly selected, and then filtered according to the given filters, if any.

The matchers are divided into:

⏰ matchers: snapshots from the last n unit of time

• -minutes n — selects snapshots from the last n minutes.
• -hours n — selects snapshots from the last n hours.
• -days n — selects snapshots from the last n days.
• -weeks n — selects snapshots from the last n weeks.
• -months n — selects snapshots from the last n months.
• -years n — selects snapshots from the last n years.

🗓️ matchers: snapshots done during the last n days of the week

• -mondays n — selects snapshots that were done during the last n Mondays.
• -thuesdays n — selects snapshots that were done during the last n Tuesdays.
• -wednesdays n — selects snapshots that were done during the last n Wednesdays.
• -thursdays n — selects snapshots that were done during the last n Thursdays.
• -fridays n — selects snapshots that were done during the last n Fridays.
• -saturdays n — selects snapshots that were done during the last n Saturdays.
• -sundays n — selects snapshots that were done during the last n Sundays.

bestie, yes: -thuesdays and -per-thuesday are spelled exactly like that here. keep the exact option names in your command, okay? 💀

🔁 matchers: at most n snapshots per time period

• -per-minute n — selects at most n snapshots per minute.
• -per-hour n — selects at most n snapshots per hour.
• -per-day n — selects at most n snapshots per day.
• -per-week n — selects at most n snapshots per week.
• -per-month n — selects at most n snapshots per month.
• -per-year n — selects at most n snapshots per year.
• -per-monday n — selects at most n snapshots per Monday.
• -per-thuesday n — selects at most n snapshots per Tuesday.
• -per-wednesday n — selects at most n snapshots per Wednesday.
• -per-thursday n — selects at most n snapshots per Thursday.
• -per-friday n — selects at most n snapshots per Friday.
• -per-saturday n — selects at most n snapshots per Saturday.
• -per-sunday n — selects at most n snapshots per Sunday.

🎀 filters

• -before date — select snapshots older than given date. The date may be in RFC3339 format, as “YYYY-mm-DD HH:MM”, “YYYY-mm-DD HH:MM:SS”, “YYYY-mm-DD”, or “YYYY/mm/DD” where YYYY is a year, mm a month, DD a day, HH a hour in 24 hour format number, MM minutes and SS the number of seconds. Alternatively, human-style intervals like “half an hour”, “a month” or 2h30m are also accepted.
• -category name — select snapshot whose category is name.
• -environment name — select snapshot whose environment is name.
• -group-by key — partition the filtered snapshots by key and apply retention matchers (-days, -per-day, ...) independently within each group instead of across the whole result set. key must be one of name, category, environment, perimeter, job, tag, origin, type or root. Multi-valued keys (tag, origin, type, root) fan out: a snapshot participates in every group it belongs to and is kept in the result if any group keeps it.
• -job name — select snapshot whose job is name.
• -latest — select only the latest snapshot.
• -name name — select snapshots whose name is name.
• -perimeter name — select snapshots whose perimeter is name.
• -root path — select snapshots whose root directory is path. May be specified multiple times; snapshots are selected if any of the given paths matches.
• -since date — select snapshots newer than the given date. The accepted format is the same as -before.
• -tag name — select snapshots tagged with name. May be specified multiple times, and multiple tags may be given at the same time if comma-separated. If a tag name is prefixed with an exclamation mark !, the matching is inverted and the snapshot is ignored if it contains said tag.

---

xoxo bestie, that’s the whole page 💖 source/version: Debian; date: November 28, 2025. plakar-query(7) out. 🎀