Skip to content

travisp/alfred-aerospace

Repository files navigation

AeroSpace Alfred Workflow

Alfred workflow for the AeroSpace window manager. It lists shortcuts from your config, executes bound actions via the AeroSpace CLI, and provides window switching and workspace overview tools.

Setup

Install AeroSpace.

Usage

Search and execute AeroSpace shortcuts (keyword is configurable in workflow settings) via the as keyword.

The as command also includes a small set of built-in AeroSpace actions when they are not bound in your config:

  • balance-sizes
  • workspace-back-and-forth
  • flatten-workspace-tree
  • reload-config
  • fullscreen --no-outer-gaps
  • layout tiling floating

These entries are shown with the subtitle no bound shortcut.

For bindings like ['flatten-workspace-tree', 'mode main'], shortcut titles are simplified to show just the actionable command (flatten-workspace-tree).

If you want a custom Alfred label for a binding, add # alfred-name: Your Label at the end of the binding line. For multiline TOML strings, put it on the closing line. Alfred will use that comment for the result title and search text while keeping the bound command unchanged. Add # alfred-skip in the same place to hide a binding from Alfred entirely.

Commands (keywords are configurable):

  • as — list shortcuts
  • ascfg — open the config file
  • asw — switch windows (default scope)
  • asw-all — switch windows (all workspaces)
  • asw-focused — switch windows (focused workspace)
  • asws — workspace overview
  • asfocused — focused window details and layout actions

Shortcuts list

Switch windows in the focused workspace via the asw-focused keyword. Focused workspace windows

Switch windows using the default scope via the asw keyword.

Switch windows across all workspaces via the asw-all keyword.

Browse workspaces and their windows via the asws keyword. Workspace overview

Inspect the focused window and change layout via the asfocused keyword. Focused window details

Workflow’s Configuration

  • Default Workspace: set the default scope for asw.
  • Notifications: toggle notifications after shortcut execution.
  • Keywords: update any keyword in workflow settings.

Notes

  • AeroSpace CLI must be available on PATH.
  • Notifications require Alfred’s Notifications permission if enabled.

Development

Rebuild the packaged workflow for local Alfred testing:

./build-workflow.sh

This writes AeroSpace.alfredworkflow. You can also pass a custom output path:

./build-workflow.sh /tmp/AeroSpace.alfredworkflow

Credits

Initially built to match the behavior of the AeroSpace Raycast extension.

About

Control the Aerospace Window Tiling Manager with Alfred

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors