v4.1.0Home

Configuration

All Foxora Shell settings live in a single TOML file. Read, write, export, and import them via fur config.

Where settings live

bash
# Default location:
~/.config/foxora/shell.toml

# Per-host override (XDG-style):
$XDG_CONFIG_HOME/foxora/shell.toml

Common keys

toml
[appearance]
theme         = "ember-dark"          # ember-dark | ember-light | <name>
font          = "JetBrains Mono"
font_size     = 14
padding       = 16                     # px around the terminal grid
row_spacing   = 4
ligatures     = true

[behaviour]
shell         = "auto"                 # auto | bash | zsh | fish | pwsh
keybindings   = "auto"                 # auto | mac | linux | windows

[topbar]
show_git      = true
show_fur      = true
show_cwd      = true

[footer]
show_status   = true
show_identity = true

[vixen]
backend       = "ollama"               # ollama | remote
model         = "llama3.1:8b"
remote        = ""                     # required if backend = "remote"

Reading and writing

bash
fur config list                  # all current values
fur config get appearance.theme
fur config set appearance.theme ember-light
fur config reset                 # back to factory defaults

fur config export > foxora.toml  # share with a teammate
fur config import foxora.toml    # merge in a partial file

Themes

Custom themes are TOML files in ~/.config/foxora/themes/. Drop a file in, then fur config set appearance.theme <name>. A future marketplace ships in v1.5; for now it's plain files.

Per-shell overrides

Underlying shell choice (bash / zsh / fish / pwsh) defaults to the host's user shell. Override it explicitly when you want consistent behaviour across hosts.