Skip to content

Desktop and terminal

Rui edited this page Nov 3, 2026 · 1 revision

Desktop and terminal

What the playbook installs for the desktop and the terminal. Their configs come from the dotfiles; using them is in the dotfiles wiki.

AeroSpace, borders, SketchyBar

  • AeroSpace (nikitabobko/tap/aerospace), the tiling window manager. ⌥f is left free for Raycast's AeroSpace extension (Raycast). The cli-apps tasks start it when it isn't running, so "running" is the desired state, not a side effect of the install.
  • JankyBorders (FelixKratz/formulae/borders) highlights the focused window.
  • SketchyBar (FelixKratz/formulae/sketchybar), the bottom status bar. Its fonts (font-sketchybar-app-font, font-sf-pro, font-hack-nerd-font) come with the fonts and aerospace tags. The GitLab, AWS and GCP items stay hidden until their CLI is logged in.
  • --tags aerospace does all of it, with the dotfiles and the macOS tweaks, and ends with the Privacy permissions guide. Syncing the dotfiles reloads them.

Ghostty and tmux

Ghostty (the tip build) and tmux (terminal and aerospace tags). Every Ghostty window starts inside tmux: Ghostty's native tabs are separate macOS windows that AeroSpace would tile, so tabs, splits and sessions come from tmux, driven by ⌘ shortcuts (⌘T, ⌘D, ⌘O for a repo, ⌘G lazygit, ⌘K sofka, ⌘J a scratch terminal; ⌘⇧H lists them all).

  • Sessions survive reboots through tmux-resurrect + tmux-continuum, cloned at pinned commits (tmux_plugins) into ~/.config/tmux/plugins, with tmux-fingers (⌘Y).
  • ⌘⇧G shows a side-by-side diff of the uncommitted changes with lumen, from custom_user_tools.

Neovim

neovim from Homebrew (the terminal role's nvim tag; the editors role adds tree-sitter-cli, which compiles the parsers); its config comes from the dotfiles.

Fonts

MesloLGS NF (Powerlevel10k), JetBrains Mono Nerd Font (Ghostty, VS Code) and the SketchyBar fonts: --tags fonts.

Clone this wiki locally