Plugin directory / Terminal / dsh-atuin
dsh-atuin
Verified · install-tested on dsh RealAlexandreAI
What it does
dsh atuin-history: record dsh user prompts into atuin shell history
Works — verified, early-stage project
dsh atuin-history: record dsh user prompts into atuin shell history It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
dsh-atuin
Record every prompt you type into DeepSeek Harness into your atuin shell history — searchable with atuin search and your shell integration (Ctrl-R).
Port of pi-atuin. dsh has no terminal UI; this is its atuin bridge.
How it works
The plugin listens to session/event → user/message and runs:
atuin history start -- "<prompt>"
atuin history end --exit 0 <ID>
Only your own typed prompts are recorded — never replies, tool calls, or file contents.
Quick start
dsh plugin --profile web add dsh-atuin
Requires a running atuin daemon (standard atuin setup). A missing atuin or stopped daemon is silently skipped — sessions never break.
Config
- id: atuin
name: dsh-atuin
config:
# atuin_bin: /opt/homebrew/bin/atuin
# deny: "^/clear$,password"
# max_len: 2000
# session_match: "project-x"
| key | meaning |
|---|---|
atuin_bin |
path to the atuin binary (default atuin on PATH) |
deny |
comma-separated regexes; matching prompts are not recorded |
max_len |
truncate long prompts (default 2000; 0 off) |
session_match |
comma-separated regexes; only matching session titles are recorded (empty = all) |
Privacy
- Only your typed prompts; replies, tool calls, and file contents are never recorded.
denysuppresses sensitive prompts.- Entries live in your local atuin DB (
~/.local/share/atuin/history.db) — nothing leaves the machine.
Development
npm install
npm run typecheck
npm test # text extraction / deny rules / truncation
npm run build
Live test against your real atuin DB (needs the daemon):
node --import tsx tests/real/real-atuin.mjs
License
MIT
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-atuin for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:RealAlexandreAI/dsh-atuinHeadless (CLI) profile:
dsh plugin --profile headless add github:RealAlexandreAI/dsh-atuinTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
When to use it
Improve the terminal experience — a TUI, command palette, or shell integration — so dsh feels native in a terminal.
Who it's for
Terminal-first developers who drive dsh from the command line and want it to behave like the CLI agents they know.
For developers — extending it
The TUI layout and shell integration are the seams — add panels, keybindings, or new shell hooks.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-atuin/)<a href="https://dshbase.com/plugins/dsh-atuin/"><img src="https://dshbase.com/badges/dsh-atuin.svg" alt="dshbase install-tested"></a>