Menu
System services configuration guide including AeroSpace, JankyBorders, and AltTab on macOS
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Step-by-step installation guide for Nix and dotfiles setup including nix.conf configuration, channel updates, home-manager, and nix-darwin
スキルのプロンプト品質を評価・チューニングする。スキルを書いたあと別のサブエージェントに実行させ、不明瞭点・自動補完箇所・達成率をレポートさせて反復改善する。Use when you want to evaluate or tune a SKILL.md prompt quality. Ref: https://zenn.dev/mizchi/articles/empirical-prompt-tuning
Generate professional English commit messages with gitmoji based on git diff. Use when creating commit messages, analyzing staged changes, or formatting commits according to conventional commits + gitmoji style.
Generate professional English commit messages with gitmoji based on git diff. Use when creating commit messages, analyzing staged changes, or formatting commits according to conventional commits + gitmoji style.
NPM tools and package management using mise including commitizen, cz-git, and global package configuration
Synchronize documentation and skills with codebase changes. Analyzes recent git changes and suggests updates to README, CLAUDE.md, and skills to keep documentation in sync.
| name | services-guide |
| description | System services configuration guide including AeroSpace, JankyBorders, and AltTab on macOS |
This document provides information about the macOS window-management stack configured in this repository: AeroSpace, JankyBorders, and AltTab.
Note: This guide is specific to macOS (darwin). For NixOS window management, see /hyprland-cheatsheet and /nixos-keybindings.
Packages are managed via Homebrew in darwin/homebrew/default.nix:
nikitabobko/tap/aerospaceFelixKratz/formulae/bordersalt-tabUser configuration is managed via Home Manager:
darwin/home-manager/aerospace/aerospace.tomldarwin/home-manager/borders/bordersrcApply changes with:
make home-manager-apply
make nix-darwin-apply
~/.aerospace.tomldarwin/home-manager/aerospace/aerospace.toml/, ,, ;, -, =tilesalt + f is not native fullscreen; it switches the current workspace into an accordion-style focused viewUse AeroSpace with these mental models:
alt + / returns the current container to normal tilingalt + , switches to accordion layoutalt + f is a stable pseudo-fullscreen inside AeroSpace, not macOS native fullscreenalt + shift + f toggles the focused window between floating and tilingalt + ; enters service mode for less common operationsCommon flows:
alt + falt + /alt + ;, then ralt + shift + 1..9alt + tabalt + ;, then shift + fBelow are the primary shortcuts configured for AeroSpace in this repo.
| Shortcut | Action |
|---|---|
alt + h | Focus left |
alt + j | Focus down |
alt + k | Focus up |
alt + l | Focus right |
| Shortcut | Action |
|---|---|
alt + shift + h | Move window left |
alt + shift + j | Move window down |
alt + shift + k | Move window up |
alt + shift + l | Move window right |
| Shortcut | Action |
|---|---|
alt + 1..9 | Switch to workspace 1..9 |
alt + shift + 1..9 | Move window to workspace 1..9 and follow it |
alt + tab | Toggle between recent workspaces |
| Shortcut | Action |
|---|---|
alt + / | Switch current container to tiles layout |
alt + , | Switch current container to accordion layout |
alt + f | Flatten workspace tree and emphasize the focused window in accordion layout |
alt + shift + f | Toggle floating / tiling |
alt + enter | Open Ghostty |
alt + r | Enter resize mode |
alt + ; | Enter service mode |
| Shortcut | Action |
|---|---|
h / l | Resize width |
j / k | Resize height |
shift + h/j/k/l | Fine-grained resize |
esc | Return to main mode |
| Shortcut | Action |
|---|---|
esc | Reload config and return to main mode |
r | Flatten workspace tree |
f | Toggle floating / tiling |
shift + f | Toggle macOS native fullscreen |
backspace | Close all windows except current |
arrow keys | Join with adjacent container |
alt + f is the recommended "focus one window" shortcut in this setupalt + f is intentionally implemented without AeroSpace fullscreen, because AeroSpace fullscreen can collapse when focus changes across workspacesalt + f, press alt + /alt + ; and press shift + falt + ; then r, and then choose alt + / or alt + , againThis configuration enables automatic startup at login:
start-at-login = true
Typical maintenance flow:
# Apply dotfiles changes
make home-manager-apply
make nix-darwin-apply
# Reload AeroSpace config manually if needed
aerospace reload-config
~/.config/borders/bordersrcdarwin/home-manager/borders/bordersrcCurrent settings:
4.0Manual restart if needed:
pkill borders || true
/opt/homebrew/bin/borders
AltTab is installed as a cask and used for app/window switching. Detailed preferences are not repo-managed yet.
Typical first-run steps:
AltTabaerospace reload-config cannot connect to server: Make sure AeroSpace.app is running, then reopen it if necessaryalt + /alt + ;, then r, then reapply alt + / or alt + ,alt + f for normal use and reserve alt + ; + shift + f for apps that truly need macOS fullscreenborders and verify ~/.config/borders/bordersrcaerospace reload-config; for border changes restart borders# Confirm packages are installed
brew list --cask | grep aerospace
brew list --cask | grep alt-tab
brew list --formula | grep borders
# Confirm managed config exists
ls -l ~/.aerospace.toml
ls -l ~/.config/borders/bordersrc
To customize the setup:
darwin/home-manager/aerospace/aerospace.tomldarwin/home-manager/borders/bordersrc for border style/colorsmake home-manager-apply