Configuration

kexsh uses a TOML configuration file for customization.

Config file location

~/.config/kex/config.toml

Or $XDG_CONFIG_HOME/kex/config.toml if XDG_CONFIG_HOME is set.

Example config

# Prefix key for entering Command mode (default: "ctrl-a")
prefix_key = "ctrl-a"

# Show the status bar at the bottom (default: true)
status_bar = true

Managing config from the CLI

kexsh config show          # Print current configuration
kexsh config set key value # Set a config value
kexsh config reset         # Reset to defaults

Available options

Option	Type	Default	Description
prefix_key	string	"ctrl-a"	Key combo to enter Command mode
status_bar	bool	true	Show mode indicator and keybinding hints

Credential storage

Authentication tokens (from kexsh login) are stored separately:

~/.config/kex/terminal/credentials.json

This file is created with 0600 permissions. See Device Registration for details.