1 files changed, 34 insertions, 0 deletions
diff --git a/desktop/modules/assistant/README.md b/desktop/modules/assistant/README.md
new file mode 100644
index 0000000..347f9ea
--- /dev/null
+++ b/desktop/modules/assistant/README.md
@@ -0,0 +1,34 @@
+# assistant
+
+Two settings pages for desktop-assistant, the daemon behind the assistant
+canvas (`../../assistant/`).
+
+**Assistant** edits the daemon's `~/.config/desktop-assistant/config.toml`
+and switches its tools. The model fields (server, temperature, tool rounds,
+thinking) save on Enter, and an emptied field falls back to the daemon's
+default, shown as its placeholder; the defaults come from `assistant.py
+--defaults`, so they are never copied here. The system prompt has its own
+box, Save and "Use the default". The tool environment (`[env]`) is one row
+per key, with an add row below. A tool's switch renames `tools/<name>.toml`
+to `<name>.toml.off`, which the daemon's `*.toml` glob skips.
+
+The daemon reads all of this only at startup, so after a change the page
+says so and offers Restart, which runs `assistant.sh restart`; a daemon that
+does not come back shows the script's status, whose log tail says why.
+
+The file is edited line by line (`Config.js`) so the comments the example
+ships with survive: an unset key sits commented out, setting it activates
+its line, and unsetting comments it back out. Every write first parses the
+whole new file with `tomllib`, then replaces the old one atomically, so an
+edit can never leave a config the daemon refuses to start with.
+
+**Ask presets** edits the canvas's canned questions for staged files:
+label, question, and the file kinds each is offered for. They live in
+`Prefs` and the canvas reads them live, so changes apply at once; "Reset to
+defaults" drops the saved list and brings back the built-in one in
+`../../assistant/Presets.js`. A new preset gets the fallback icon.
+
+Search finds the model fields, every `[env]` key, every tool and every
+preset by name.
+
+Check: `node desktop/modules/assistant/test_config.js`.