Safe configs: Omachy will never overwrite your ~/.zshrc (only appends a managed block), ~/.tmux.conf (skipped if it exists), or ~/.config/nvim/ (skipped if it exists). Your customizations are always safe.

quick reference

expand all keybindings
Focus
Alt HFocus left
Alt JFocus down
Alt KFocus up
Alt LFocus right
Move
Alt Shift HMove window left
Alt Shift JMove window down
Alt Shift KMove window up
Alt Shift LMove window right
Layout
Alt /Toggle tiles H/V
Alt ,Toggle accordion H/V
Alt Shift SpaceToggle floating
Alt FFullscreen
Workspace
Alt 1-9Switch to workspace 1-9
Alt Shift 1-9Move window to workspace 1-9
Alt TabPrevious workspace
Alt Shift TabMove workspace to next monitor
Workspace (Named)
Alt DDev workspace
Alt WWeb workspace
Alt MMessages workspace
Alt EEmail workspace
Alt SScratch workspace
Window
Alt EnterOpen new terminal
Alt QClose window
Alt -Resize smaller
Alt =Resize larger
Service Mode
Alt Shift ;Enter service mode
EscReload config & exit
RFlatten workspace tree
FToggle floating
BackspaceClose all except current
Resize Mode
Alt REnter resize mode
H / LResize width
J / KResize height
Enter or EscExit resize mode
Tmux Panes
Ctrl-B VSplit horizontal
Ctrl-B XSplit vertical
Ctrl-B H/J/K/LNavigate panes
Ctrl-B Shift H/J/K/LResize panes
Tmux Windows
Ctrl-B CNew window
Ctrl-B 1-9Switch to window N
Ctrl-B N / PNext / previous window
Ctrl-B RReload tmux config
Tmux Copy Mode
Ctrl-B [Enter copy mode
VBegin selection
Shift VSelect line
YCopy to clipboard

managing windows

AeroSpace is a tiling window manager — windows automatically arrange themselves to fill the screen. All keybindings use Alt (Option) as the modifier.

Focus & Move

Navigate between windows with vim-style keys:

Alt H/J/K/LFocus left / down / up / right
Alt Shift H/J/K/LMove window left / down / up / right

Open a new terminal with Alt Enter and close any window with Alt Q.

Layouts

AeroSpace supports several layout modes:

Alt /Toggle between horizontal and vertical tiles
Alt ,Toggle between horizontal and vertical accordion
Alt Shift SpaceToggle floating / tiling
Alt FmacOS native fullscreen

Tiles split the screen evenly between windows. Accordion stacks windows and shows one at a time, like tabs. Floating lets you position a window freely.

Workspaces

By default, workspaces are numbered 1-9:

Alt 1-9Switch to workspace
Alt Shift 1-9Move window to workspace
Alt TabSwitch to previous workspace

If you installed with --named-workspaces, workspaces are named instead:

Alt DDev
Alt WWeb
Alt MMessages
Alt EEmail
Alt SScratch

Named workspaces also auto-route apps: Ghostty and Safari go to Dev, Chrome to Web, Slack and Teams to Messages, and Mail to Email.

Service Mode

Service mode provides advanced window operations. Press Alt Shift ; to enter, then:

EscReload config & exit
RFlatten workspace tree (reset layout)
FToggle floating
BackspaceClose all windows except current
Alt Shift H/J/K/LJoin window with neighbor

Each action automatically exits service mode.

Resize Mode

Press Alt R to enter resize mode, then use vim keys to resize:

H / LShrink / grow width
J / KGrow / shrink height
- / =Smart shrink / grow

Press Enter or Esc to exit resize mode.

using the terminal

Ghostty

Your terminal is Ghostty with Catppuccin Mocha theme, JetBrains Mono font at 13pt, and a slightly transparent background (95% opacity). The titlebar is hidden for a cleaner look.

Tmux

Tmux is your terminal multiplexer. The prefix key is Ctrl-B — press it before any tmux command.

Splits & panes:

Ctrl-B VSplit horizontal
Ctrl-B XSplit vertical
Ctrl-B H/J/K/LNavigate between panes
Ctrl-B Shift H/J/K/LResize panes

Windows:

Ctrl-B CNew window
Ctrl-B 1-9Switch to window by number
Ctrl-B N / PNext / previous window

Copy mode uses vi keybindings. Press Ctrl-B [ to enter, V to select, Y to copy to system clipboard.

The status bar uses the Dracula theme. Windows and panes are numbered starting at 1. Mouse support is enabled.

Zsh

Your shell includes several enhancements:

dev sessions

The dev command creates a purpose-built tmux development environment for any project.

Usage

$ dev ~/projects/myapp

If no path is given, it uses the current directory. The session is named after the directory.

What It Creates

Four tmux windows, each with a specific role:

Ctrl-B 1 — nvimOpens Neovim on the project root (you land here)
Ctrl-B 2 — gitOpens Lazygit for staging, committing, browsing
Ctrl-B 3 — serverEmpty window for dev servers, watchers, etc.
Ctrl-B 4 — scratchEmpty window for ad-hoc commands

Session Reuse

Running dev again for the same project reattaches to the existing session instead of creating a new one. Your state is preserved.

Example Workflow

# start a dev session
$ dev ~/projects/myapp

# you land in Neovim (window 1) — edit code
# Ctrl-B 2 → stage and commit with Lazygit
# Ctrl-B 3 → start your dev server
# Ctrl-B 1 → back to the editor
Tip: Combine with AeroSpace workspaces — keep your dev session in the Dev workspace (Alt D with named workspaces) and your browser in Web (Alt W).

window borders

JankyBorders draws a subtle border around each window. The active window gets a purple glow, while inactive windows have a faint gray border. This makes it easy to tell which window has focus at a glance.