docs: document NO_ANIMATIONS, instructions array, /hooks, /stash

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.
This commit is contained in:
Hunter Bown
2026-05-03 06:39:29 -05:00
parent a368dc53b8
commit 5627d6535b
+49
View File
@@ -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 (`<workspace>/.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)