Ephemeral-AI-Lab/dsh-plugins
Quick start · Packages · Development · Documentation > 🧠 Give your DSH sessions better tools, durable workflows, and a cleaner path from idea to execution.
catalog 简介 / catalog descriptioncatalog description:Make Deepseek Harness Great
安装Install
dsh plugin --profile web add dsh-codex-terminal@0.1.3
把 Ephemeral-AI-Lab/dsh-plugins 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
🧩 DSH Harness Plugins
Small, focused plugins that make DeepSeek Harness more capable, expressive, and pleasant to use.
Quick start · Packages · Development · Documentation
🧠 Give your DSH sessions better tools, durable workflows, and a cleaner path from idea to execution.
⚡ Quick start
Published plugins install directly into a DSH profile with one command. The
examples below target the web profile; replace web with the profile you use.
🐚 Codex Terminal
# With the DSH CLI:
dsh plugin --profile web add dsh-codex-terminal@0.1.3
# Without the `dsh` CLI:
npm install dsh-codex-terminal@0.1.3
🔐 Codex Coding Plan
Reuse an existing file-backed codex login from the DSH Models page:
dsh plugin --profile web add ./coding-plan/codex
# Grok Coding Plan models from the existing `grok login`
dsh plugin --profile web add ./coding-plan/grok
⏰ Loop
# With the DSH CLI:
dsh plugin --profile web add dsh-loop@0.1.3
# Without the `dsh` CLI:
npm install dsh-loop@0.1.3
🧪 Mock — unstable
dsh-mock is published for early testing. Its commands, API, and UI may
change before a stable release.
# With the DSH CLI:
dsh plugin --profile web add dsh-mock@0.1.0
# Without the `dsh` CLI:
npm install dsh-mock@0.1.0
🧭 Sessions
Inspect, create, read, and message DSH sessions with the current session tools:
# With the DSH CLI:
dsh plugin --profile web add dsh-sessions@0.1.1
# Without the `dsh` CLI:
npm install dsh-sessions@0.1.1
Restart DSH and create a new session after installing a plugin. If dsh is not
on your PATH, run the same command from a DeepSeek Harness source checkout with
pnpm dsh instead.
Direct npm installation downloads the package for use by your project. DSH profile installation is still required when you want DSH to load the plugin as part of a profile.
📦 Packages
| Package | Status | What it adds | Docs |
|---|---|---|---|
dsh-codex-coding-plan |
🧪 Local · 0.1.0 |
Reuses a file-backed Codex ChatGPT login through the existing openai-codex pi-ai provider. |
README |
dsh-grok-coding-plan |
🧪 Local · 0.1.0 |
Reuses a file-backed Grok subscription login through the existing xai pi-ai provider. |
README |
dsh-codex-terminal |
✅ Published · 0.1.3 |
Codex-compatible exec_command and write_stdin tools with persistent command sessions. |
README · npm |
dsh-loop |
✅ Published · 0.1.3 |
Session-scoped recurring alarms, loop tools, slash commands, and a web UI. | README · npm |
dsh-mock |
⚠️ Unstable · ✅ Published · 0.1.0 |
Deterministic mock model turns and replay commands routed through the real DSH AgentLoop and ToolRuntime. | README · SPEC · npm |
dsh-sessions |
✅ Published · 0.1.1 |
Session discovery, bounded reads, creation, and delivery through session tools and /sessions. |
README · SPEC · npm |
🐚 dsh-codex-terminal
Run shell commands like a Codex-style agent: start long-running processes, poll for output, and send input to persistent sessions. PTY transport is used by default with a configured pipe fallback when PTY allocation is unavailable.
⏰ dsh-loop
Create durable, session-local recurring prompts that can be managed through
agent tools, /loop commands, and the web UI. Loops resume with the session
and keep each alarm independent from the others.
🧪 dsh-mock
Exercise deterministic mock model turns through /mock run and /mock replay
while preserving the real DSH AgentLoop, ToolRuntime, policy, and event flow.
⚠️ Unstable: published as
dsh-mock@0.1.0for early testing. The command, API, and UI surface may change before a stable release.
Install it into the DSH web profile with one command:
dsh plugin --profile web add dsh-mock@0.1.0
🛠️ Development
Each plugin is independently installable and testable. For example:
cd loop
pnpm install
pnpm test
pnpm build
The source tree intentionally stays outside the DeepSeek Harness repository; DSH composes plugins through profile-scoped installation and patch layers.
📚 Documentation
- Codex Terminal documentation
- Coding Plan core
- Codex Coding Plan documentation
- Grok Coding Plan documentation
- Loop documentation
- Mock documentation
- Mock implementation specification
- Sessions documentation
- Sessions specification
- DeepSeek Harness
Harness architecture and how-to guides
🤝 Contributing
Issues, ideas, and pull requests are welcome. Keep plugins focused, document their runtime contracts, and include tests for changes to tools, persistence, or UI behavior.
📄 License
Released under the MIT License.
ruvnet/ruflo
amruthpillai/reactive-resume
volcengine/OpenViking
Molunerfinn/PicGo
titanwings/colleague-skill
nocobase/nocobase