GitHub - magicmark/spacelist

2 min read Original article ↗

Skip to content

Navigation Menu

spacelist

A beautiful terminal UI for viewing all windows across your Aerospace window manager spaces.

Features

  • Lists all windows organized by workspace
  • Real-time filtering by application name
  • Beautiful TUI with syntax highlighting using Bubble Tea
  • Shows workspace names, application names, and window titles
  • Only displays workspaces that contain windows

Installation

Homebrew (recommended)

brew install magicmark/tap/spacelist

From source

go build -o spacelist
cp spacelist /usr/local/bin/spacelist

Usage

Simply run:

Controls

  • Type to filter windows by application name (case-insensitive)
  • Esc or Ctrl+C to quit
  • Enter to focus the selected window and quit spacelist

FAQs

Error: Apple could not verify...

Run this to launch spacelist from a CLI wrapper:

xattr -d com.apple.quarantine /opt/homebrew/bin/spacelist

How it works

The application:

  1. Queries aerospace list-workspaces --all --json to get all workspaces
  2. For each workspace, runs aerospace list-windows --workspace <name> --json
  3. Displays results in a filterable TUI using Charm's Bubble Tea library

Libraries Used