Configuration

Nex uses a TOML configuration file at %APPDATA%\Nex\config.toml. Auto-created on first launch. Most settings hot-reload; hotkey and index_db_path require restart.

Core

Setting	Type	Default	Description
hotkey	string	Ctrl+Space	Global hotkey to toggle overlay
launch_at_startup	bool	true	Start Nex on Windows sign-in
max_results	u16	20	Results per query (5–100)
show_files	bool	false	Include files in search results
show_folders	bool	false	Include folders in search results
search_mode_default	string	all	Default mode: all, apps, files, actions, clipboard

Search & Discovery

Setting	Type	Default	Description
search_dsl_enabled	bool	true	Enable DSL operators (kind:, modified:, AND, OR, NOT)
file_discovery_backend	string	auto	auto, everything, walkdir
discovery_roots	string[]	[user dir]	Folders scanned for file discovery
discovery_exclude_roots	string[]	[temp, cache]	Excluded folders
web_search_provider	string	google	google, duckduckgo, bing, brave, startpage, ecosia, yahoo, custom
web_search_custom_template	string	""	URL template with {query}

Clipboard

Setting	Type	Default	Description
clipboard_enabled	bool	false	Enable clipboard history
clipboard_retention_minutes	u32	480	Retention in minutes (5–43200)
clipboard_exclude_sensitive_patterns	string[]	[password, otp, ...]	Patterns that prevent capture

Plugins

Setting	Type	Default	Description
plugins_enabled	bool	true	Enable plugin system
plugins_safe_mode	bool	true	Prevent plugin command execution
plugin_paths	string[]	[%APPDATA%\Nex\plugins]	Plugin directories

Performance

Setting	Type	Default	Description
active_memory_target_mb	u16	72	Active memory target (20–512 MB)
idle_cache_trim_ms	u32	900	Cache trim delay after hide (100–10000 ms)
ui_warm_release_ms	u32	5000	WebView resident time after hide (500–600000 ms)
game_mode_enabled	bool	false	Suppress hotkey during fullscreen games

Index

Setting	Type	Default	Description
index_max_items_total	u32	120000	Maximum indexed items across all roots
index_max_items_per_root	u32	40000	Max per discovery root (≤ total)
index_max_items_per_query_seed	u32	5000	Candidate budget per file query

Example

hotkey = "Ctrl+Space"
launch_at_startup = true
max_results = 20
show_files = false
file_discovery_backend = "auto"
web_search_provider = "google"
clipboard_enabled = false
plugins_enabled = true
active_memory_target_mb = 72
game_mode_enabled = false