Shell Kit¶

Shell configuration: oh-my-zsh, tmux, and direnv.

Activation: Always on — active in every container.

What's Included¶

oh-my-zsh with the robbyrussell theme
tmux with a pre-configured setup
direnv hooks in both bash and zsh
PATH configuration for fnm and mise in both shells

Configuration¶

kits:
  shell:
    disabled: true           # disable this default-on kit
    build:                   # custom commands to run at image build time
      - "curl -fsSL https://deno.land/install.sh | sh"

Option	Type	Default	Description
`disabled`	bool	`false`	Disable this kit
`build`	list	`[]`	Custom shell commands to run during the image build (base image if declared in the global config, else the project image)

tmux Configuration¶

The pre-installed tmux config includes:

Mouse support enabled
256-color terminal
50,000 line scroll history
| to split horizontally, - to split vertically
Status bar: hostname (left), date/time (right)

Custom Build Commands¶

The build option runs arbitrary commands during the image build. This is the escape hatch for installing tools that don't fit into other kit categories:

kits:
  shell:
    build:
      - "curl -fsSL https://deno.land/install.sh | sh"
      - "go install golang.org/x/tools/gopls@latest"

Commands run as your host user. See Packages for more details.