SETTLE(1)

💖 SETTLE(1) 💖

okay bestie, welcome to the settle era — specifically the query subcommand, and yeah it's a User Commands page so you know it's the real deal 🫶

---

✨ NAME ✨

settle query — bestie, it queries the database. that's the whole vibe. that's the assignment 💅

---

🌸 SYNOPSIS 🌸

settle {query|-Q} [OPTIONS]

so you can spell it out as query or just hit it with the lil shorthand -Q — both iconic, both valid, no notes ✨

---

🦋 DESCRIPTION 🦋

it queries the database. literally that. the database gets queried. you ask, it tells. main character energy fr fr 💜

---

🎀 OPTIONS 🎀

okay this is the part where we get specific, and she is specific. every flag, every regex, all of it 🍓

• -t, --title <REGEX> — keeps the Zettel whose title matches your regex 💖
• -p, --project <REGEX> — keeps the Zettel that live in the matching projects 🗂️
• -g, --tag <REGEX> — keeps the Zettel that have a matching tag name 🏷️
• -x, --text <REGEX> — keeps the Zettel that contain some text 🔍
• -l, --links <REGEX> — keeps the Zettel that have links to the matching Zettel 🔗
• -b, --backlinks <REGEX> — keeps the Zettel that have links from the matching Zettel 🪞
• -o, --loners — keeps the Zettel that don't have any links to and fro — no links in, no links out, just vibing alone 😭🫶
• -f, --format <FORMAT> — prints it formatted ✨
• -s, --link_sep <SEPARATOR> — tells it what separator to use for links and backlinks in that formatted output 🎀
• --graph <GRAPH> — turns your query results into a graph. the options are 'dot', 'json' or 'vizk' 👑
• -e, --exact — matches everything exactly, which means regex is off, she's not doing that today 🙈
• -h, --help — prints help. the classic. the legend 🫶

ngl bestie, watch out for --exact — the second you turn it on, regex is disabled. so if you were counting on pattern matching, that plan is cancelled 💀

---

💌 one last thing

this whole page is brought to you by settle query version 0.40.1, and it was written down in August 2025. slay, periodt, go query something iconic 🌈⭐💜