Struct Config 

pub struct Config {

    pub version: u32,
    pub theme: ThemeName,
    pub locale: LocaleName,
    pub check_for_updates: bool,
    pub editor: EditorConfig,
    pub file_explorer: FileExplorerConfig,
    pub file_browser: FileBrowserConfig,
    pub clipboard: ClipboardConfig,
    pub terminal: TerminalConfig,
    pub keybindings: Vec<Keybinding>,
    pub keybinding_maps: HashMap<String, KeymapConfig>,
    pub active_keybinding_map: KeybindingMapName,
    pub languages: HashMap<String, LanguageConfig>,
    pub fallback: Option<LanguageConfig>,
    pub lsp: HashMap<String, LspLanguageConfig>,
    pub warnings: WarningsConfig,
    pub plugins: HashMap<String, PluginConfig>,
    pub packages: PackagesConfig,
}

Main configuration structure

Fields

version: u32

Configuration version (for migration support) Configs without this field are treated as version 0

theme: ThemeName

Color theme name

locale: LocaleName

UI locale (language) for translations If not set, auto-detected from environment (LC_ALL, LC_MESSAGES, LANG)

check_for_updates: bool

Check for new versions on startup (default: true). When enabled, also sends basic anonymous telemetry (version, OS, terminal type).

editor: EditorConfig

Editor behavior settings (indentation, line numbers, wrapping, etc.)

file_explorer: FileExplorerConfig

File explorer panel settings

file_browser: FileBrowserConfig

File browser settings (Open File dialog)

clipboard: ClipboardConfig

Clipboard settings (which clipboard methods to use)

terminal: TerminalConfig

Terminal settings

keybindings: Vec<Keybinding>

Custom keybindings (overrides for the active map)

keybinding_maps: HashMap<String, KeymapConfig>

Named keybinding maps (user can define custom maps here) Each map can optionally inherit from another map

active_keybinding_map: KeybindingMapName

Active keybinding map name

languages: HashMap<String, LanguageConfig>

Per-language configuration overrides (tab size, formatters, etc.)

fallback: Option<LanguageConfig>

Fallback configuration for files whose type cannot be detected. Applied when no extension, filename, glob, or built-in detection matches. Useful for setting a default grammar (e.g., “bash”) and comment_prefix for unrecognized .conf, .rc, .rules, etc. files.

lsp: HashMap<String, LspLanguageConfig>

LSP server configurations by language. Each language maps to one or more server configs (multi-LSP support). Accepts both single-object and array forms for backwards compatibility.

warnings: WarningsConfig

Warning notification settings

plugins: HashMap<String, PluginConfig>

Plugin configurations by plugin name Plugins are auto-discovered from the plugins directory. Use this to enable/disable specific plugins.

packages: PackagesConfig

Package manager settings for plugin/theme installation

Implementations

impl Config

pub fn load_from_file<P: AsRef<Path>>(path: P) -> Result<Self, ConfigError>

Load configuration from a JSON file

This deserializes the user’s config file as a partial config and resolves it with system defaults. For HashMap fields like lsp and languages, entries from the user config are merged with the default entries.

pub fn resolve_keymap(&self, map_name: &str) -> Vec<Keybinding>

Resolve a keymap with inheritance Returns all bindings from the keymap and its parent chain

pub fn validate(&self) -> Result<(), ConfigError>

impl Config

pub fn find_config_path(working_dir: &Path) -> Option<PathBuf>

Find the first existing config file, checking local directory first.

Returns None if no config file exists anywhere.

pub fn load_with_layers( dir_context: &DirectoryContext, working_dir: &Path, ) -> Self

Load configuration using the 4-level layer system.

Merges layers in precedence order: Session > Project > User > System Falls back to defaults for any unspecified values.

pub fn read_user_config_raw(working_dir: &Path) -> Value

Read the raw user config file content as JSON.

This returns the sparse user config (only what’s in the file, not merged with defaults). Useful for plugins that need to distinguish between user-set values and defaults.

Checks working directory first, then system paths.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&Config> for PartialConfig

fn from(cfg: &Config) -> Self

Converts to this type from the input type.

impl JsonSchema for Config

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.