KAS-SHELL(1)

💖 KAS-SHELL(1) 💖

okay bestie, welcome to kas-shell — it's the shell plugin from the kas manual suite, and it's literally about to hand you a whole build environment like it's nothing 🫶

---

✨ NAME ✨

kas-shell — the kas shell plugin 🐚

---

🌸 SYNOPSIS 🌸

kas shell [-h] [--skip STEP] [--force-checkout] [--update] [-E] [-k]
          [-c COMMAND]
          [config]

---

🦋 DESCRIPTION 🦋

So the whole vibe here? You run a shell inside the build environment. That's it, that's the plugin 💅

This plugin is what makes the kas shell command happen.

When you fire this command off, kas goes and checks out your repositories, sets up the build environment, and then starts a shell in that build environment. Iconic. You'd do this when you wanna manually run bitbake with your own custom command line options, or when you wanna execute other stuff like runqemu. Also — the SHELL environment variable is inherited from the calling environment, and that's</> the thing controlling which shell actually gets started. no cap.

Like, say you wanna start a shell in the build environment for the file kas-project.yml — you'd just run:

kas shell kas-project.yml

Orrrr if you wanna invoke qemu to test an image you've already built:

kas shell kas-project.yml -c 'runqemu'

obsessed, honestly 😭

---

🎀 OPTIONS 🎀

💜 Positional Arguments

• config — the config file(s), separated by colon. If you don't specify one, it uses .config.yaml in KAS_WORK_DIR. (yes, it just assumes. it's confident like that 💅)

🌈 Named Arguments

• --skip=[] — skip build steps. Wanna skip more than one? Use this argument multiple times, bestie. The possible choices are: setup_dir, setup_home, make_non_interactive, init_setup_repos, repo_setup_loop, finish_setup_repos, repos_checkout, repos_apply_patches, setup_environ, write_bbconfig
• --force-checkout=False — always checkout the desired commit/branch/tag of each repository, discarding any local changes. like, bye to your edits, fr fr 💀
• --update=False — pull new upstream changes to the desired branch even if it's already checked out locally
• -E=False, --preserve-env=False — keep the current user environment block
• -k, --keep-config-unchanged — skip the steps that change the configuration
• -c='', --command='' — run command

---

👑 KAS 👑

Part of the kas(1) suite. you know, the family. main character energy runs in the blood ✨

---

🌟 Author 🌟

Daniel Wagner, Jan Kiszka, Claudius Heine 🫶

🌸 Copyright 🌸

Siemens and contributors, 2017-2025

---

okay that's the whole page, you ate it, go build something gorgeous 🎀✨

version 5.4, dated Jun 25, 2026 — mwah, talk later bestie 💖🦋