kitten-run-shell(1)

🐚 kitten-run-shell — the manual, but make it cute 💅

okay so this is kitten-run-shell from the kitten manual, and honestly? it's the glow-up your shell deserves. ✨

---

🌸 Name

kitten-run-shell — run the user's shell with shell integration enabled. that's it. that's the whole vibe. 🫶

---

🦋 Usage

kitten run-shell [options] [optional cmd to run before running the shell ...]

so you've got your [options] and then optionally a [optional cmd to run before running the shell ...] — lowkey a command that runs before the shell kicks in. main character energy fr. 👑

---

💖 Description

bestie, this literally runs the user's configured shell. and if that shell supports shell integration? it enables it, based on whatever the user's configured shell_integration setting says. no cap, it just knows. 🧚

---

✨ Options

• --shell-integration — specify a value for the shell_integration option, overriding the one from kitty.conf. your config could never 💀
• --shell [=.] — specify the shell command to run. the default value of . will use the parent shell if it's recognized, falling back to the value of the shell option from kitty.conf. it's giving "i'll figure it out myself" 💅
• --env — specify an env var to set before running the shell. of the form KEY=VAL. can be specified multiple times. if no = is present, KEY is unset. yes, unset. that's the rule. 🎀
• --cwd — the working directory to use when executing the shell. where we're going, we don't need roads, we need a cwd. 🛣️
• --inject-self-onto-path [=always] — add the directory containing this kitten binary to PATH. the directory is added only if it's not already present (we're not out here duplicating entries, be serious 🙈).

choices: always, never, unless-root — pick your fighter 🌈

• --help, -h [=no] — show help for this command. always here for you when you're confused. 🫂

---

🌟 a lil sign-off 🎀

this whole thing is version 0.49.2, dated Oct 01, 2026 — shoutout to the kitten manual for keeping it iconic. now go run your shell, bestie. slay. 💜🔥