better-dsh
其他 活跃维护

better-dsh

pgmi-builds/better-dsh

Make your dsh ready for serious coding. (Tools x Schemas)^REPL. skill://, ctx://, agent://, dvc://, dsh://, IPython REPL, Context as Variables, cross compaction recallable, full context revive. hash-edit, dvc://browser, subagent as a function, workflow as a function.

4
Stars 标星
0
Forks 分支
4
Watchers 关注
0
Open Issues
TypeScript
主要语言
MIT
开源协议
3.9 MB
仓库大小
18 天前
最后推送
一键安装扩展 / 插件指令
dsh plugin --profile web add github:pgmi-builds/better-dsh
git clone https://github.com/pgmi-builds/better-dsh.git
git clone git@github.com:pgmi-builds/better-dsh.git
README.md main

Better Dsh — Dashr

dsh plugin npm package Repository License

Dashr (/ˈdæʃ.ɚ/) makes your native dsh ready for serious coding.


Why

  • $(\text{Tools} \times \text{URL schemas})^{\text{REPL}}$ - a concise, cognitively frictionless setup delivering maximal capacity.
  • Universal Tools - read, write, grep, glob.
  • URL schemas - skill://, ctx://, agent://, dvc://, dsh://, an intuitive, unified interface for runtime resources.
  • Persistent REPL Kernel - IPython (compared with the native ephemeral TS REPL).
  • (30+ tools × 5 schemas) ^ REPL free composition = <∞>
  • Context as Variables - full session transcripts are accessible as variables, even cross compactions.
  • Full Context Revive — full-namespace dill snapshots save and restore kernel state across restarts.

One eval call — the formula made concrete:

{ "cell": "
  scout = await agent('agent://ralph', 'graph-analyze this codebase; scout the breaking points to add tests')
  ui    = await read('dvc://browser/127.0.0.1:3080')   # the live web UI as a device
  me    = await read('ctx://transcript')               # this session, as a variable
", "description": "one cell: agents × devices × session" }

✨ Other Features

  • Agent swarm as resources — sub-agents, workflows, and Ralph loops are first-class calls (subagent, workflow, ralph, message).
  • KeepRecency context compactions - preserve recent relevancy. Resets the default 80% compaction threshold to 50% as "usable" context max.
  • A simplistic global LLM-endpoint failover, absent in the native build (a safeguard for long-range, unattended tasks).
  • keeps the system prompt to ~3–4K tokens.
  • dvc://browser - browser use ready.
  • All host plane wired — you do not even see any difference from your dsh UI; it just silently fuels up the dsh base.
  • iOS PWA Ready - minor UI twists that make it a decent PWA for iOS Add to Home Screen.

Recommended Companion Plugin(s)


⚡ Quick Install

dsh plugin --profile web add --config.auto-install-peers=false better-dsh@latest

📚 Inspiration & Attribution

better-dsh is an open-source plugin for DeepSeek Harness (dsh) (MIT). It stands on the shoulders of earlier open-source work:

  • BetterEdit (dsh-better-edit, by Rianico) — the hash-anchored readeditundo_last_edit editing model. Dashr adopts this toolchain (itself a lineage of pi-hashline-editpi-hashline-edit-lszdsh-better-edit) with attribution, and re-wires it natively.
  • omp-agent (oh-my-pi, by Can Bölük) — the dvc:// device framework and its ast_edit / ast_grep / browser / lsp devices, adopted under its MIT license.
  • Prime Agent (Prime Intellect) — the Context as Variables paradigm that shapes the persistent-kernel model.

All upstream dependencies carry their original MIT licenses, recorded in the source tree.


📄 License

MIT. See LICENSE.