Skip to main content

Layouts

aibox ships four tmux layouts. Harness placement follows [ai].harness_order: the 1st harness is the first enabled harness in that order, then the 2nd, 3rd, and so on. Enabled harnesses missing from harness_order are appended in canonical order.

Generated layouts can include an extended PowerKit status bar with host, network, development, cloud, resource, and aibox runtime segments.

Available Layouts

ai

WindowContents
1 · workleft 50%: yazi · right 50%: 1st harness
2 · aiall further harnesses, split as full-height even horizontal panes
3 · lazygitlazygit, when git-ui selects lazygit
3/4 · shellbash

dev

WindowContents
1 · workleft 50%: yazi top 50% / 1st harness bottom 50% · right 50%: shell
2 · lazygitlazygit, when git-ui selects lazygit
2/3 · aiall further harnesses, split as full-height even horizontal panes
final · shellbash

focus

WindowContents
1 · filesyazi
2..n · harness nameone fullscreen window per harness in harness_order
next · lazygitlazygit, when git-ui selects lazygit
final · shellbash

cowork

WindowContents
1 · workleft 50%: yazi · right 50%: shell
2 · aiall harnesses, split as full-height even horizontal panes
3 · lazygitlazygit, when git-ui selects lazygit

Setting The Default Layout

[customization]
layout = "dev"

Options: dev, focus, cowork, ai.

Per-Session Override

aibox up --layout focus

This does not change the default in aibox.toml.