Configuration

Two TOML files, both optional:

Unknown keys are an error. examples/config.toml uses every key.

Worktrees

key	meaning
`base`	the branch new branches start from
`prefix`	added to new branch names, like `"you/"`
`setup`	a command run in each new worktree
`clone`	files copied from the main checkout into new worktrees
`commit_times`	date files by their last commit
`editor`	your editor; otherwise `$EDITOR`
`names`	places to name worktrees after, used before mia's own
`[launch]`	named windows: `logs = "tail -f log/dev.log"`

key	meaning
`image`	the container image
`image_setup`	baked into the image
`setup`	run in each new container
`ports`	ports the app serves
`page`	the port `mia env browse` opens
`host_ports`	ports on your computer the container can reach
`pass_host`	send the original `Host` header
`container_only`	paths kept inside the container, like `node_modules`
`cache`	container paths shared by the repository's environments
`pass`	environment variables passed from your shell

id, run, health, autostart, restart ("on-failure" or "on-unhealthy"), grace (seconds).

key	meaning
`[tools] copy`	files copied into environments
`[tools] credentials`	copied only with `mia env tools --credentials`
`[dotfiles] env`	files for every environment's home
`[dotfiles] shell`	the shell in environments
`[dotfiles] packages`	packages installed in environments
`[dotfiles] setup`	run in every environment
`[dotfiles] machine`	files for other machines' home

[keys]
machines = "B"
down = ["j", "down"]

[popup]
width = "80%"
height = "75%"

plugins = ["gh"]

[plugin.gh]
# that plugin's own settings