sqitch-log-usage(3pm)

🎀 NAME 🎀

okay so bestie, this is sqitch-log-usage — the manual page for the Sqitch log usage statement. that's the whole vibe. it's the rundown of how you talk to sqitch log, the command that spills the tea on your deploy history. no cap, it's short and sweet. 💖

---

✨ USAGE ✨

here's the whole flex, literally one line:

sqitch log [options] [<database>]

yeah. that's it. you give it some options, you optionally give it a <database>, and it does its thing. main character energy fr. 💅

---

💅 OPTIONS 💅

listen, there are a LOT of options, but don't panic. they come in three lil friend groups: Search, Formatting, and Connection. let's go. 🫶

🔍 Search options

these are the ones that decide what actually shows up.

• -t, --target <target> — the database to which to connect. like, which one are we even talking to, bestie? 🎯
• --event <type> — pick the type of event. only that flavor of history, pls. 📌
• --change-pattern, --change <name> — match a regex against change names. yes, a regex. filter by the changes you care about. 🔍
• --committer-pattern, --committer <name> — match a regex against committer names. stalking a specific person's commits? valid. 👀
• -n, --max-count <count> — show only the specified number of events. a lil snack instead of the whole buffet. 🍓
• --skip <number> — skip the specified number of events. scroll past the first few, no biggie. ⏭️
• --reverse — show events in reverse order. flip the whole timeline upside down. 🔄
• --no-reverse — don't show events in reverse order. keep it in normal order, thank u. ↪️

🎨 Formatting

this is the glow-up section. how does the output look?

• -f, --format <format> — show events in the specified format. you want it cute, you say so. ✨
• --date-format, --date <format> — show dates in the specified format. dates but make them your brand. 📅
• --color — use ANSI colors. pretty lil rainbow terminal, we love to see it. 🌈
• --no-color — never use ANSI colors. for when you're logging to a file and colors would be chaos. 🚫
• --abbrev — abbreviate change IDs. long IDs are doing too much honestly. ✂️
• --oneline — shorthand for --format oneline --abbrev 6. one line per event, six-char IDs, iconic. ⭐
• --headers — show headers for the target. label it up. 🏷️
• --no-headers — don't show target headers. keep it bare. 🙈

🔌 Connection

the "how do we even get there" section. all the plumbing. 🛠️

• --registry <registry> — registry schema or database. 🗂️
• --db-client <path> — path to the engine command-line client. 🧭
• -d, --db-name <name> — database name. 📛
• -u, --db-user <user> — database user name. 👤
• -h, --db-host <host> — database server host name. 🖥️
• -p, --db-port <port> — database server port number. 🔢

and that's the whole page, bestie. every option accounted for, nothing skipped, periodt. 💖

---

okay one last lil sign-off because we're being cute about this: this page came to you courtesy of perl v5.40.1, dated 2026-07-26, and it lives in the docs as sqitch-log-usage(3pm). 🦋 mwah, go log some stuff. 🫶✨