From 5627d6535bed5afa85299457348f0e09842c99ae Mon Sep 17 00:00:00 2001 From: Hunter Bown Date: Sun, 3 May 2026 06:39:29 -0500 Subject: [PATCH] docs: document NO_ANIMATIONS, instructions array, /hooks, /stash MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Catches up `docs/CONFIGURATION.md` with the v0.8.8 polish stack so operators have one source of truth for the new surfaces: * `NO_ANIMATIONS` env override (#450) joins the existing environment-variable list, with a cross-reference to `docs/ACCESSIBILITY.md`. * New `### Instruction sources` section documents the `instructions = [...]` config field (#454): expansion rules, 100 KiB per-file cap with `[…elided]` marker, missing-file warning behavior, and the project-wholesale-replaces-user override semantics. * New `### /hooks listing` section documents the read-only slash command (#460 MVP) so users know how to introspect configured lifecycle hooks without `cat`-ing config.toml. * New `### Composer stash` section documents Ctrl+S + `/stash list|pop|clear` (#440) including the 200-entry cap and multiline preservation. Pure documentation; no code changes. Existing prompt-stability and config-loading tests are unaffected. --- docs/CONFIGURATION.md | 49 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) diff --git a/docs/CONFIGURATION.md b/docs/CONFIGURATION.md index d95e3b4e..bf174b00 100644 --- a/docs/CONFIGURATION.md +++ b/docs/CONFIGURATION.md @@ -151,6 +151,55 @@ These override config values: - `DEEPSEEK_CAPACITY_PRIOR_V4_PRO` - `DEEPSEEK_CAPACITY_PRIOR_V4_FLASH` - `DEEPSEEK_CAPACITY_PRIOR_FALLBACK` +- `NO_ANIMATIONS` (`1|true|yes|on` forces `low_motion = true` and + `fancy_animations = false` at startup, regardless of the saved + settings; see [`docs/ACCESSIBILITY.md`](./ACCESSIBILITY.md)). + +### Instruction sources (`instructions = [...]`, #454) + +Add a list of additional system-prompt sources that get +concatenated, in declared order, alongside the auto-loaded +`AGENTS.md`: + +```toml +instructions = [ + "./AGENTS.md", + "~/.deepseek/global.md", + "~/team/agents-shared.md", +] +``` + +Rules: + +- Paths run through `expand_path` so `~` and env vars work. +- Each file is capped at 100 KiB; oversized files are + truncated with a `[…elided]` marker rather than skipped. +- Missing files are skipped with a tracing warning so a stale + entry doesn't fail the launch. +- Project config (`/.deepseek/config.toml`) + **replaces** the user array wholesale rather than merging. + If you want both, list `~/global.md` inside the project + array. Set `instructions = []` in the project to clear the + user list for that repo. + +### `/hooks` listing + +Run `/hooks` (or `/hooks list`) inside the TUI to see every +configured lifecycle hook grouped by event, including each +hook's name, command preview, timeout, and condition. The +`[hooks].enabled` flag's state is shown at the top so it's +obvious when hooks are globally suppressed. Hooks are +configured under `[[hooks.hooks]]` entries — see the existing +hook-system documentation for the full schema. + +### Composer stash (`/stash`, Ctrl+S) + +Press **Ctrl+S** in the composer to park the current draft to +`~/.deepseek/composer_stash.jsonl`. `/stash list` shows parked +drafts with one-line previews and timestamps; `/stash pop` +restores the most recently parked draft (LIFO); `/stash clear` +wipes the file. Capped at 200 entries; multiline drafts +round-trip intact. ## Settings File (Persistent UI Preferences)