AEROSPACE-LIST-APPS(1)

📦 version 0.21.3-Beta, in nixpkgs unstable

💅 AEROSPACE-LIST-APPS 💅

okay bestie, welcome to aerospace-list-apps(1) — yep, that's a section 1 manual page from the AeroSpace Manual, and yes you're about to read the whole thing with me. grab a boba. 🧋

✨ NAME ✨

aerospace-list-apps — prints the list of running applications that appears in the Dock and may have a user interface. that's it. that's the whole gig. 💖

🦋 SYNOPSIS 🦋

aerospace list-apps [-h|--help] [--macos-native-hidden [no]] [--format <output-format>] [--count] [--json]

look at all those flags. slay. 👑

🌸 DESCRIPTION 🌸

Print the list of running applications that appears in the Dock and may have a user interface.

fr fr, that's the vibe — it gives you the apps, and only the ones that show up in the Dock and may have a UI. like, the visible ones. the main characters. 💅

and here's the tea: the command is useful to inspect list of applications to compose filter for on-window-detected callback. so if you're out here writing callbacks and you need to know what to filter on, this is your girl. iykyk. ✨

🎀 OPTIONS 🎀

  • -h, --help — Print help. classic. does exactly what it says on the tin, no notes. 🙈
  • --macos-native-hidden [no] — Filter results to only print hidden applications. and then [no] inverts the condition — so you get the not-hidden ones instead. flip it and reverse it. 🔄
  • --format <output-format> — Specify output format. peek the Output Format section below for the whole breakdown. heads up: it's incompatible with --count — they cannot coexist, it's giving exes at the same party. 😭
  • --count — Output only the number of apps. that's it, just a number, minimalism core. Incompatible with: --format, --json. so pick a lane bestie. 💀
  • --json — Output in JSON format. Can be used in combination with --format to specify which data to include into the json. but it's incompatible with --count — no counting and json-ing at the same time, sorry not sorry. 🌈

💜 OUTPUT FORMAT 💜

Output format can be configured with optional [--format <output-format>] option. and <output-format> supports string interpolation — here's the wiki if you wanna go down that rabbit hole: https://en.wikipedia.org/wiki/String_interpolation. 🧚

If not specified, the default <output-format> is:

%{app-pid}%{right-padding} | %{app-bundle-id}%{right-padding} | %{app-name}

cute, right? three columns, nicely padded. obsessed. 🫶

The following variables can be used inside <output-format>:

  • %{app-bundle-id} — String. Application unique identifier. Bundle ID — https://developer.apple.com/documentation/appstoreconnectapi/bundle_ids. the government name of your app basically. 🪪
  • %{app-name} — String. Application name. the name your app actually goes by. 💖
  • %{app-pid} — Number. UNIX process identifier — https://en.wikipedia.org/wiki/Process_identifier. the numeric id, the social security number of processes. 🔢
  • %{app-exec-path} — String. Application executable path. where the actual binary lives. 🗺️
  • %{app-bundle-path} — String. Application bundle path. where the whole .app bundle lives. 📦
  • %{right-padding} — A special variable which expands with a minimum number of spaces required to form a right padding in the appropriate column. it's literally just vibes-based spacing. a little cushion. 🛋️
  • %{newline} — Unicode U+000A newline symbol \n. line break moment. ⬇️
  • %{tab} — Unicode U+0009 tab symbol \t. the tab. the classic. ➡️

🔥 RESOURCES 🔥

go read the guide bestie, it's giving helpful. 📚

💀 BUGS 💀

Bugs can be reported to: https://github.com/nikitabobko/AeroSpace/discussions/categories/potential-bugs

Maintainers will move verified bugs to: https://github.com/nikitabobko/AeroSpace/issues

so like, discuss first, and if it's actually a bug they'll graduate it over to the issues. pipeline. 📈

ngl if something's broken, say something — but put it in the discussions category first, that's the whole system. 🫡

👑 LICENSE 👑

Copyright © 2023 Nikita Bobko

Free use of this software is granted under the terms of the MIT License.

You can find the full text of AeroSpace license and its dependencies in the 'legal' directory of the distributed zip archive. so it's literally right there in the zip, go look. 🎁

⭐ AUTHOR ⭐

Nikita Bobko and contributors 💜

and that's the whole page!! periodt. 🦋✨

this has been aerospace-list-apps(1) from the AeroSpace Manual, dated 2026-07-16, source version AeroSpace — mwah, love u, go list some apps. 💅💖
📦 where this page comes from