Configuration#

Config Files#

toe reads config in this order (later values override earlier ones):

File	Purpose
`$XDG_CONFIG_HOME/toe/config.toml`	User config
`$XDG_CONFIG_HOME/toe/languages.toml`	User language config
`.toe/config.toml`	Workspace config (trusted workspaces only)
`.toe/languages.toml`	Workspace language config (trusted workspaces only)

$XDG_CONFIG_HOME defaults to ~/.config.

Open your user config directly: :config_open
Open workspace config: :config_open_workspace
Reload after editing: :config_reload

Workspace Trust#

Workspace-local config files (.toe/config.toml and .toe/languages.toml) are only loaded for trusted workspaces. Untrusted workspaces silently skip these files — only user config applies.

Trust the current workspace:

:workspace_trust

Remove trust:

:workspace_untrust

Trusted workspaces are stored in $DATA_DIR/trusted_workspaces (~/.local/share/toe/trusted_workspaces on Linux/macOS).

To bypass trust checks entirely and always load workspace config, set in your user config:

[editor]
insecure = true

Editor Options#

Options can be changed at runtime with :set <key> <value>, :get <key>, and :toggle <key> (for booleans).

Theme#

theme = "frappe"   # frappe | latte | macchiato | mocha

General#

Option	Type	Default	Description
`editor.mouse`	bool	`true`	Enable mouse support
`editor.middle-click-paste`	bool	`true`	Paste on middle-click
`editor.insecure`	bool	`false`	Disable workspace trust checks
`editor.editor-config`	bool	`true`	Respect `.editorconfig` files
`editor.auto-session`	bool	`true`	Save/restore session automatically
`editor.default-line-ending`	string	(system)	`lf`, `crlf`, or `native`

Display#

Option	Type	Default	Description
`editor.line-number`	string	`"absolute"`	`absolute` or `relative`
`editor.cursorline`	bool	`false`	Highlight cursor line
`editor.cursorcolumn`	bool	`false`	Highlight cursor column
`editor.text-width`	int	`80`	Text width (used by rulers and reflow)
`editor.rulers`	int[]	`[]`	Column ruler positions, e.g. `[80, 120]`
`editor.bufferline`	string	`"never"`	Show buffer tabs: `never`, `always`, `multiple`

Soft Wrap#

Option	Type	Default	Description
`editor.soft-wrap.enable`	bool	`false`	Enable soft wrap
`editor.soft-wrap.max-wrap`	int	`20`	Maximum visual indentation when wrapping
`editor.soft-wrap.max-indent-retain`	int	`40`	Max indent levels to retain
`editor.soft-wrap.wrap-indicator`	string	`"↪ "`	Continuation indicator
`editor.soft-wrap.wrap-at-text-width`	bool	`false`	Wrap at `text-width` instead of window width

Whitespace and Indentation#

Option	Type	Default	Description
`editor.whitespace.render`	string	`"none"`	`none` or `all`
`editor.indent-guides.render`	bool	`false`	Show indent guides
`editor.indent-guides.character`	string	`"│"`	Guide character
`editor.indent-guides.skip-levels`	int	`0`	Indent levels to skip
`editor.gutters.line-numbers.min-width`	int	`3`	Minimum gutter width

Editing#

Option	Type	Default	Description
`editor.auto-pairs`	bool	`true`	Auto-insert closing brackets and quotes
`editor.continue-comments`	bool	`true`	Extend comment tokens on new lines
`editor.atomic-save`	bool	`true`	Write via temp file to prevent partial writes
`editor.insert-final-newline`	bool	`true`	Ensure file ends with a newline
`editor.trim-final-newlines`	bool	`false`	Remove trailing blank lines on save
`editor.trim-trailing-whitespace`	bool	`false`	Remove trailing spaces on save

Auto-Save#

Option	Type	Default	Description
`editor.auto-save`	bool	`false`	Save when focus is lost (alias for `auto-save.focus-lost`)
`editor.auto-save.focus-lost`	bool	`false`	Save when focus leaves the view
`editor.auto-save.after-delay.enable`	bool	`false`	Save after idle delay
`editor.auto-save.after-delay.timeout`	int	`3000`	Idle delay in milliseconds

Search#

Option	Type	Default	Description
`editor.search.smart-case`	bool	`true`	Case-insensitive unless pattern has uppercase
`editor.search.wrap-around`	bool	`true`	Wrap search at end of file

Scrolling#

Option	Type	Default	Description
`editor.scrolloff`	int	`5`	Lines of context kept above/below cursor
`editor.scroll-lines`	int	`3`	Lines moved per scroll step

Cursor Shape#

Option	Type	Default	Description
`editor.cursor-shape.normal`	string	(terminal)	`block`, `bar`, or `underline`
`editor.cursor-shape.insert`	string	(terminal)	Cursor shape in Insert mode
`editor.cursor-shape.select`	string	(terminal)	Cursor shape in Select mode

Status Bar#

Option	Type	Default	Description
`editor.statusline.separator`	string	`" "`	Separator between status items
`editor.statusline.mode.normal`	string	`"normal"`	Label for Normal mode
`editor.statusline.mode.insert`	string	`"insert"`	Label for Insert mode
`editor.statusline.mode.select`	string	`"select"`	Label for Select mode

Pickers#

These options are TOML-only and cannot be changed at runtime with :set.

TOML key	Type	Default	Description
`editor.buffer-picker.start-position`	string	`"top"`	`top` or `previous`
`editor.file-explorer.hidden`	bool	`false`	Show hidden files
`editor.file-explorer.follow-symlinks`	bool	`false`	Follow symlinks
`editor.file-explorer.parents`	bool	`false`	Include parent directories
`editor.file-explorer.ignore`	bool	`false`	Respect `.ignore` files
`editor.file-explorer.git-ignore`	bool	`false`	Respect `.gitignore`
`editor.file-explorer.git-global`	bool	`false`	Respect global gitignore
`editor.file-explorer.git-exclude`	bool	`false`	Respect git exclude rules
`editor.file-explorer.flatten-dirs`	bool	`true`	Collapse single-child directories

Shell#

[editor]
shell = ["sh", "-c"]   # default on Unix; ["cmd", "/C"] on Windows

Config Example#

theme = "mocha"

[editor]
cursorline = true
soft-wrap.enable = true
auto-session = true
rulers = [80, 120]

[editor.cursor-shape]
normal = "block"
insert = "bar"

Language Config#

See Language Servers for languages.toml configuration.