spacelist

README

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:

spacelist

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

• Bubble Tea - TUI framework
• Bubbles - TUI components (text input)
• Lip Gloss - Styling and layout