Guide
Configuration
Zagros reads a single TOML file, zagros.toml, from its config directory. Run zagros --config to open it. Changes are picked up the next time the launcher opens.
toml
hotkey = "Alt+Space"theme = "" # empty follows the Windows light/dark settingmax_results = 8start_with_windows = truescan_dirs = ["D:\Portable Apps"] [providers]clipboard = trueemoji = false # missing providers are enabled [aliases]"proj" = "D:\Projects""gh" = "https://github.com" [[web_search]]keyword = "g"name = "Google"url = "https://www.google.com/search?q={q}" [everything]enabled = truelimit = 20# dll_path = "C:\Program Files\Everything\Everything64.dll" [marketplace]registry_url = "https://avestura.github.io/zagros/registry.json"Options #
| Key | Default | Meaning |
|---|---|---|
hotkey | Alt+Space | Global shortcut that toggles the launcher. |
theme | empty | Theme name. Empty follows Windows light/dark. See Themes. |
max_results | 8 | Rows shown in the result list. |
providers | all on | Table of provider name to true or false. |
scan_dirs | none | Extra folders the apps provider scans for shortcuts and executables. |
aliases | none | Keyword to path, URL or command. |
web_search | Google and a few others | Array of tables with keyword, name, and a url containing {q}. |
everything | enabled if found | Options for the Everything integration. |
marketplace.registry_url | the project registry | Point this at your own registry.json to run a private marketplace. |
start_with_windows | false | Adds Zagros to your user startup entries. |
updates.background | true | Check GitHub for a newer Zagros and the registry for newer extensions in the background, download and verify a newer Zagros, and say so briefly (✔ Update installed · Restart to update). Set false to turn it off; the update keyword and the tray item still check on demand. updates.check_on_start is ignored. |
mcp.http | false | Serve the MCP API search for coding agents over HTTP while Zagros runs. |
mcp.addr | 127.0.0.1:7777 | Loopback address for the HTTP server. Other addresses are refused. |
mcp.token | empty | Optional bearer token HTTP clients must send. |
Everything integration #
If Everything is running, Zagros queries it through its SDK DLL for instant file search. Zagros looks for Everything64.dll in the usual places; set everything.dll_path if yours lives somewhere else.