incant(1)

📦 version 0.5, in ubuntu resolute, ubuntu stonking

💖 incant(1) — like, the manual page, but make it make sense 💖

User Commands ✨ yes bestie, you're in the right place, this is the incant(1) page and we're gonna get you fluent in it in like two minutes flat.

🌸 NAME 🌸

incant — an Incus frontend for declarative development environments 🦋

Okay so real talk: incant is the glow-up wrapper around Incus that lets you describe your whole dev setup in a file instead of typing a hundred commands like it's 2009. Declarative. Iconic. Periodt.

✨ SYNOPSIS ✨

incant [OPTIONS] [COMMAND]

That's it. Options, then a command. You got this 💅

🎀 DESCRIPTION 🎀

So incant is a command-line tool that gives you a declarative way to manage Incus development environments. The way that it works?? It reads a YAML configuration file and that file defines your instances, all their properties, and the provisioning steps that need to happen. No cap. 🧚

You write the vibe down once, and incant makes the vibes real.

💅 OPTIONS 💅

  • -v, --verbose — turns on verbose mode. She gets chatty. You get to see everything happening. Obsessed 🫶
  • -f, --config PATH — the path to your configuration file. Point her at the YAML of your dreams ✨

👑 COMMANDS 👑

  • init — creates an example configuration file right in the current directory. Your starter pack. Your blank canvas. Slay 🎨
  • up [NAME] — starts and provisions an instance. And if you don't hand her a name? She does it for all the instances. Go big or go home 💖
  • provision [NAME] — provisions an instance, or every instance if you don't give a name. Same energy, provisioning edition 🌈
  • shell [NAME] — opens a shell into an instance. And here's the cute part: if you don't give a name and there's only one instance, she just uses that one. Main character energy, no decisions required 💀
  • destroy [NAME] — destroys an instance, or all of them if no name is given. RIP boo 👋 but like, intentionally.
Careful bestie!! No name means all instances. That's not a drill, that's a whole environment gone. Double-check before you hit enter, fr fr 😭
  • dump — shows you the generated configuration file. A little reveal moment 🪞
  • list — lists every instance defined in your configuration. Roll call, everybody answer 📋

🍓 FILES 🍓

  • incant.yaml — the default configuration file. If you don't tell her otherwise with -f, this is the one she's reading. It's giving home base 🏠

🌟 SEE ALSO 🌟

🦋 AUTHORS 🦋

August 2025.

And that's the whole page!! This was the incant(1) manual, filed under User Commands, dated August 2025 — thanks for reading bestie, now go declare an environment and make it everyone's problem 💖✨🎀🫶

📦 where this page comes from