dsh-plugins

🧠 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.0 for 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

• Project guide
• Tool reference
• Ephemeral AI Harness preset
• 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.