INCUS.TOP(1)

✨ incus-top — the manual page but make it a vibe ✨

okay bestie, so this is incus-top, a page from the Incus - Command line client manual (section 1, for the record 💅), and it's genuinely one of the cutest little commands in the whole toolbox. Let's get into it. 🫶

---

🌸 NAME 🌸

incus-top — display resource usage info per instance

like, it's giving "peek at how much your instances are chomping on your machine." 🔥

---

🎀 SYNOPSIS 🎀

incus top [:] [flags]

---

💖 DESCRIPTION 💖

Description:

Displays CPU usage, memory usage, and disk usage per instance. obsessed, actually. 💅

Default column layout: numD

🦋 Columns 🦋

so the -c option takes a comma separated list of arguments, right, and those arguments control which instance attributes get output when you're displaying in table or compact format. it's giving "you are the main character of your own table."

Column arguments are the pre-defined shorthand chars (peep the list below 👇), and the commas between consecutive shorthand chars are optional — no cap, you can just smash them together if you want. ✨

Column shorthand chars:

• D — disk usage
• e — Project name
• m — Memory usage
• n — Instance name
• u — CPU usage (in seconds)

---

✨ OPTIONS ✨

• --all-projects[=false] — display instances from all projects, every single one of them, no crumbs left behind 💖
• -c, --columns="numD" — Columns 🤩
• -f, --format="table" — Format (table|compact)
• --refresh=10 — Configure the refresh delay, in seconds ⏱️ (so it re-checks every 10 by default, iconic)

---

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

these ones are the hand-me-downs from the big parent command, still slaying:

• --debug[=false] — show all the debug messages 🐛
• --explain[=false] — if the command is valid, explain its parsed arguments instead of actually running it (like a vibe check for your flags, before anything happens) 👀
• --force-local[=false] — force using the local unix socket
• -h, --help[=false] — Print help 🆘
• --project="" — Override the source project
• -q, --quiet[=false] — Don't show progress information 🙈 (silent era)
• --sub-commands[=false] — Use with help or --help to view sub-commands
• -v, --verbose[=false] — Show all information messages 🗣️
• --version[=false] — Print version number

---

💜 SEE ALSO 💜

• incus(1)

go read that one too, it's the whole fam. 🫶

---

⭐ HISTORY ⭐

• 24-Sep-2026 — Auto generated by spf13/cobra

---

ngl bestie, this whole page was Auto generated by spf13/cobra — that's the source, and the version/date stamp on it is Sep 2026, from the Incus - Command line client manual. periodt. 💅✨

okay that's the whole page, go run it and watch your instances glow 💖🦋🎀