KSSHELL(1)

💖 KSSHELL — an interactive kickstart shell 💖

okay bestie, welcome to ksshell(1), a.k.a. the interactive kickstart shell from the General Commands Manual, and honestly? she's a whole vibe. ✨

---

🌸 SYNOPSIS 🌸

ksshell [-i | --input INFILE]  [-o | --output OUTFILE]  [-v | --version VERSION]

---

🦋 DESCRIPTION 🦋

so ksshell is, like, the interactive kickstart shell. no cap. 💅

here's the tea: you can hand her an input kickstart file as your starting point if you want (optional, she's chill like that), then you get to sit there and add whatever extra kickstart commands your heart desires, and when you're done she writes the finished kickstart file out to stdout — or to the file name you gave her. obsessed.

she also supports all the usual readline niceties, including tab completion of kickstart commands and their options — though not the values those options can take. so you get the command, you get the flag, you're on your own for the argument. tragic, i know. 😭

and beyond understanding literally every kickstart command, ksshell has some builtin commands of her own, because working with kickstart files inside a shell should be easy, periodt:

• .clear — clears the existing kickstart data, including anything that came from INFILE. it's giving "fresh start, blank slate, new me." basically starts you over from nothing. 🫧
• .quit — quits the interactive shell. if you gave her an OUTFILE she saves to it, and if you didn't, she prints to stdout instead. either way, bye bestie 👋
• .show — prints the current kickstart file state. like a little mirror for your config. 🪞

---

⭐ EXIT STATUS ⭐

• ksshell returns 0 on success. slay. 👑
• she returns 1 if VERSION is incorrect. don't get the version wrong, it's not the move. 💀
• if INFILE does not exist, a warning gets printed — but you still get dumped into the interactive shell anyway. so like, she's disappointed but she's not gonna abandon you. 🥺

---

✨ OPTIONS ✨

• -i, --input INFILE — the name of the input kickstart file. your starting point, your blueprint, your beginning. 🎀
• -o, --output OUTFILE — writes the flattened kickstart file to OUTFILE, or to stdout if you don't give a filename. no filename = she's yelling into the void (stdout). 🌈
• -v, --version VERSION — use this version of kickstart syntax when processing the file. if you don't give a version, she just uses the latest one, because she's a forward-thinking icon. ⭐

---

🧚 SEE ALSO 🧚

• ksflatten (1)
• ksvalidator (1)
• ksverdiff (1)

---

and that's the whole manual, bestie!! 🫶 this was the KSSHELL(1) page from the General Commands Manual — mwah, go forth and kickstart responsibly 💖✨🎀