KAS-CHECKOUT(1)

💖 kas-checkout — the man page, but make it cute 💖

okay bestie, welcome to KAS-CHECKOUT(1), part of the kas manual suite 🦋 this is the glow-up guide for kas checkout, and no cap, it's literally the move you want when you need everything checked out before the build starts. let's get into it 💅

---

✨ NAME ✨

kas-checkout — the kas checkout plugin 🎀 (yes that's the whole vibe)

---

🌸 SYNOPSIS 🌸

kas checkout [-h] [--skip STEP] [--force-checkout] [--update] [config]

like… that's it. that's the whole summoning ritual 🫶

---

💫 DESCRIPTION 💫

so what does it actually DO. it checks out all necessary repositories and sets up the build directory exactly as the configuration file tells it to. iconic behavior honestly.

this plugin is what implements the kas checkout command, fr fr 👑

when you run this command, kas will checkout repositories and set up the build directory as specified in the chosen config file. and like — why would you even want that? because it's useful if you need to inspect the configuration or modify any of the checked out layers before starting a build ✨ peek first, build later, that's the energy.

for example, to setup the configuration described in the file kas-project.yml you could run:

kas checkout kas-project.yml

slay. look at you go 💅

---

🎀 OPTIONS 🎀

Positional Arguments

• config — the Config file(s), separated by colon. and if you don't specify one at all, it'll just use .config.yaml inside KAS_WORK_DIR. cute, convenient, defaults ✨

Named Arguments

• --skip=[] — skip build steps, bestie 🫶 and if you want to skip more than one step, just use this argument multiple times, no biggie.

possible choices (the whole menu, don't lose any of them): 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. yeah. that means your local edits? gone. gone gone. it's giving "commit first or cry later" 😭
• --update=False — pull new upstream changes to the desired branch even if it is already checked out locally. so if the branch is already sitting there on your machine, this still goes and grabs the fresh stuff from upstream 🔥

---

👑 KAS 👑

part of the kas(1) suite. you know the family 💜

---

🦋 Author 🦋

Daniel Wagner, Jan Kiszka, Claudius Heine 🌈 absolute legends, the way they made this whole thing

---

🌸 Copyright 🌸

Siemens and contributors, 2017-2025

---

ok so that's literally the whole page, bestie — go check out those repos and set up that build dir, you're the main character of this terminal 🫶💖

---

kas 5.4 ✨ Jun 25, 2026 ✨ KAS-CHECKOUT(1) — mwah, that's the version, the date, and the manual name, all wrapped up with a bow 🎀 bye bestie!! 🧚💅