dsh-client-ui-quickfill
Terminal-style prompt history & fast completion for the DSH web composer.
Brings the scrollback of a shell to your AI input: recall past prompts,
search them instantly, and fill them with a keystroke.
- Recall —
Alt+↑/Alt+↓ cycle prompt history (even on multiline drafts);
bare ↑/↓ works on single-line drafts. The first ↑ applies zsh's
up-line-or-search: if the draft is a prefix of some entry, jump to the
newest matching one and keep stepping within that prefix only.
- Search —
Ctrl+R (or Cmd+R) opens a fuzzy history-search picker:
typing narrows (subsequence match), ↑/↓ selects, Ctrl+R again jumps to
the next match (reverse-i-search), Enter fills, Esc closes.
- Complete — while typing, the newest entry that starts with the draft is
shown as a gray ghost right after the caret (fish-style autosuggestion);
Tab or → at the end accepts it as an ordinary, undoable draft write.
- Protect — your partially typed draft and caret are restored exactly when
you cycle back to newest (or press
Esc). Consecutive duplicates are
collapsed, empty prompts are never recorded, and IME composition
(Chinese pinyin) passes every key through untouched.
- Optional cross-session pool — an opt-in global history (
localStorage)
extends search, prefix recall and the ghost to prompts from every session,
like zsh's SHARE_HISTORY. Off by default for privacy.
Requirements
- DSH web profile (
dsh --profile web), version 0.1.0-rc.8 line.
- pnpm (
npm install -g pnpm) for dsh plugin management.
Install (community users)
dsh plugin --profile web add dsh-client-ui-quickfill
Then add the bundle to the profile's composite package list
(~/.dsh/profiles/web/package.json):
"dependencies": {
"dsh-client-ui-quickfill": "^0.1.0"
}
Restart the dsh web service — the node side scans bundles at startup,
applies their cordis.patch.yml and bakes the client into the
window.__DSH_BOOT__ boot graph; only a restart activates a new bundle.
The plugin is a self-registering bundle: its patch layer inserts the
ui-quickfill browser roster row automatically. No hand-written
cordis.patch.yml is needed.
Build & test (contributors)
npm install # link peer dependencies
npm test # smoke tests: derivation, matching, prefix walk, ghost, pool
npm pack # inspect the published file set
To test against a live instance, point a web-test profile at this directory:
"dependencies": {
"dsh-client-ui-quickfill": "file:../../dsh-client-ui-quickfill"
}
or symlink it into ~/.dsh/profiles/node_modules and restart.
Data storage (browser-local only, no server)
| localStorage key | Contents |
|---|
dsh-quickfill.global-history | Cross-session prompt pool (globally unique, capped at 500, newest last) |
dsh-quickfill.settings | Toggles (global) |
- The global pool is off by default (privacy: prompts may be sensitive).
It stays in this browser and never leaves the device; session data already
lives in
~/.dsh on disk, so this is a same-trust-domain local cache.
- Enabling it merges the current session's whole history in once, then new
prompts append automatically; session entries always rank first.
- Clear: DevTools → Application → Local Storage → delete the keys.
Known limitations
Cmd+R on macOS doubles as the browser reload shortcut and interception is
not always reliable; Windows/Linux are unaffected.- History comes from the loaded conversation snapshot;
loadOlder pages load
in on demand.
Ctrl+R is swallowed while a slash command is claimed or a send is in
flight (draft protection); press Esc first, then search.- Ghost layer mirrors the composer's computed font metrics; unusual theme
font overrides can drift the glow 1–2px. Multiline drafts and empty drafts
disable the ghost intentionally.
- Split composers: textarea lookup is scope-locked to the seat's conversation
(
[data-conversation-scroll]), so split layouts should work — not yet
exercised in a split layout.
License
MIT — see LICENSE.
中文说明
见 README.zh-CN.md。
