kaem(1)

💖 NAME 💖

okay bestie, meet kaem — it's like running with scissors but shell scripts without a shell. no cap, that's literally the tagline. 💅

---

✨ SYNOPSIS ✨

kaem [--file FILE --strict --verbose --nightmare-mode]

---

🎀 DESCRIPTION 🎀

so the whole point of kaem is that it's the most minimal shell you could possibly need in bootstrap processes — and the way it serves is that it can function as an init, which means the whole bootstrap can happen with only itself and a hex0 assembler as the only binaries running on the system. that's it. that's the whole squad. 👑

At its core, here's the vibe: it reads a line — except when that line is terminated with a '\', in which case it reads the next line too (yes bestie, it's a continuation, we love her) — and then it collects the arguments into an array, looks up the program in the path provided by the name, or if that doesn't hit, in the ENVIRONMENT, and then executes that program with the specified options. slay.

If no filename is passed, kaem then attempts to execute a file called kaem.run — which is, and I cannot stress this enough, the standard name for kaem scripts. iconic. 🦋

Wanna know how to level it up? here's the tea:

• If you wish for kaem to stop when one of the lines throws or returns an error code, simply add --strict.
• If you wish to see what is being executed, simply add --verbose.
• If you hate dealing with an environment and want to eliminate it entirely, --nightmare-mode.

yes the flag is literally called --nightmare-mode. no I'm not kidding. it's giving unhinged and I respect it so much. 💀

---

🌈 EXAMPLES 🌈

Typically, kaem will be in running scripts used in bootstrapping, so like:

# kaem --verbose --strict
# kaem -f bootstrap.sh --nightmare-mode

look at her go. main character energy fr fr. ✨

---

🌸 COMPATIBILITY 🌸

kaem is compatible with all Turing complete machines — even the ones that try to be Turing complete -1. 🧚

---

💜 AUTHORS 💜

Jeremiah Orians <Jeremiah@pdp10.guru>

---

👑 COPYRIGHT 👑

Copyright 2016-2019 Jeremiah Orians <Jeremiah@pdp10.guru>

License GPLv3+.

---

🍓 SEE ALSO 🍓

M1(1), hex2(1), blood-elf(1), get_machine(1), syscalls(2)

---

and that's the whole page bestie — this one's a Linux special from JULY 2019, and yeah, it lives under the kaem(1) glow-up. go bootstrap something cute. 🫶💖