STG-INIT(1)

💅 stg-init — bestie edition ✨

okay so real talk, this is the stg-init page from the StGit manual, and we're gonna get you so caught up on it 🫶

---

🌸 NAME 🌸

stg-init — literally just initializes a StGit stack on a branch, no cap 💖

---

🎀 SYNOPSIS 🎀

stg init [OPTIONS]

that's it. that's the whole vibe. ✨

---

🦋 DESCRIPTION 🦋

okay so bestie, here's the tea: this command initializes a StGit stack on a branch 💅

when you initialize a branch with a StGit stack, it commits initial, empty stack state for that branch to the repository. those stack metadata commits are tracked by the refs/stacks/<branch> reference, iykyk. every StGit command that modifies the stack commits updated stack state. and like — good news — if you're a StGit user, you never have to touch the refs/stacks/<branch> ref directly, bestie. it's giving main character energy but it handles itself 💀

✨ fun fact: some StGit commands, like stg new and stg uncommit, will automatically initialize the stack for you. so it's often not even necessary to explicitly initialize the stack on a branch. also, branches created with stg branch --create are automatically initialized. slay. 👑

but — and this is the important bit, bestie — the branch must already exist and point to a commit before you can initialize a StGit stack on it. no branch, no commit, no stack. periodt. 🎀

also lowkey: StGit stack metadata can be deinitialized from a branch using stg branch --cleanup. see stg-branch(1) for the full rundown. 💖

---

💅 OPTIONS 💅

• -b <branch>, --branch=<branch> — use <branch> instead of the current branch, like, if you're feeling spicy and want to init somewhere else 🌈

---

🧚 STGIT 🧚

part of the StGit suite — go peek at stg(1) if you wanna see the whole fam 💜

---

and that's the whole page, bestie! ✨ this lil manual is from StGit 2.7.0, dated 10/17/2026 — so go forth and initialize those stacks, you iconic Unix queen 👑💖