TOMCLI-GET(1)

💖 TOMCLI-GET 💖

okay bestie, so this is tomcli-get — the CLI for working with TOML files. and before you ask, it's pronounced "tom clee." 🎀 yes fr fr. it lives in the General Commands Manual section, and honestly? she's giving main character energy.

---

✨ SYNOPSIS ✨

[tomcli-get | tomcli get] [OPTIONS] PATH [SELECTOR]

like, you can call her either way — tomcli-get or tomcli get — she answers to both, periodt. 💅

---

🦋 DESCRIPTION 🦋

the tomcli-get subcommand supports querying TOML files. that's the whole vibe. you point her at a TOML file, you tell her what key you want, she goes and gets it. no cap. 🔥

---

🌸 ARGUMENTS 🌸

• PATH — the path to a TOML file to read. Use '-' to read from stdin. yep, a literal single dash, that's the "gimme the data through the pipe" move, iconic behaviour honestly 🫶
• [SELECTOR] (default: .) — a dot separated map to a key in the TOML mapping. it's optional, she defaults to ., but when you wanna get specific:
  • Example: 'section1.subsection.value'
  • or, when your key is being dramatic and has dots in it: '"key.with.dots".abc'

like yes, you can quote the key inside the selector, she understands the assignment ✨

---

💅 OPTIONS 💅

• --version — show the version and exit. classic. she tells you who she is and dips 😌
• --writer <tomli_w|tomlkit> — library to use to write TOML files. pick your fighter: tomli_w or tomlkit 🥊
• --reader <tomli|tomlkit> — library to use to write TOML files. (yes, it literally says "write" in the reader description, we are not making the rules, that's just what the page says 🙈) Defaults to tomlkit and falls back to tomli/tomllib if tomlkit is unavailable. so she's got a backup plan, she's prepared, love that for her 💖
• -F / --formatter <default: default> — which output formatter to use. the default is literally default (so meta, we love it). See tomcli-formatters(1) for a full list. there are options, go look, iykyk 👑

---

👑 SEE ALSO 👑

• tomcli(1)
• tomcli-formatters(1)
• tomcli-set(1)

go read those too, they're all part of the same friend group 🧚

---

⭐ and that's the whole page bestie! no skipped options, no missing flags, every single detail intact — we keep the facts, we just add the sparkle 💜

this was TOMCLI-GET(1), source/version dated 2025-09-19, from the General Commands Manual — mwah, stay hydrated, go query some TOML 🍓✨