Language-specific settings and settings for particular language servers can be configured in a languages.toml file placed in your configuration directory. Helix actually uses two languages.toml files, the first one is in the main helix repository; it contains the default settings for each language and is included in the helix binary at compile time. Users who want to see the available settings and options can either reference the helix repo's languages.toml file, or consult the table in the adding languages section.

A local languages.toml can be created within a .helix directory. Its settings will be merged with both the global and default configs.

Changes made to the languages.toml file in a user's configuration directory are merged with helix's defaults on start-up, such that a user's settings will take precedence over defaults in the event of a collision. For example, the default languages.toml sets rust's auto-format to true. If a user wants to disable auto-format, they can change the languages.toml in their configuration directory to make the rust entry read like the example below; the new key/value pair auto-format = false will override the default when the two sets of settings are merged on start-up:

# in <config_dir>/helix/languages.toml

name = "rust"
auto-format = false

Tree-sitter grammars

Tree-sitter grammars can also be configured in languages.toml:

# in <config_dir>/helix/languages.toml

name = "rust"
source = { git = "", rev = "a250c4582510ff34767ec3b7dcdd3c24e8c8aa68" }

name = "c"
source = { path = "/path/to/tree-sitter-c" }

You may use a top-level use-grammars key to control which grammars are fetched and built.

# Note: this key must come **before** the [[language]] and [[grammar]] sections
use-grammars = { only = [ "rust", "c", "cpp" ] }
# or
use-grammars = { except = [ "yaml", "json" ] }

When omitted, all grammars are fetched and built.