aerospace-join-with(1)

Synopsis

aerospace join-with [-h|--help] [--window-id <window-id>] (left|down|up|right)

Put the focused window and the nearest node in the specified direction under a common parent container

Given this layout

h_tiles
├── window 1
├── window 2 (focused)
└── window 3

join-with right will result in the following layout

h_tiles
├── window 1
└── v_tiles
    ├── window 2 (focused)
    └── window 3

Note	`join-with` is a high-level replacement for i3’s split command. There is an observation that the only reason why you might want to split a node is to put several windows under a common "umbrella" parent. Unlike `split`, `join-with` can be used with `enable-normalization-flatten-containers`