dsh-custom-instructions
Codex-style custom instructions for DeepSeek Harness: edit a global instruction from the settings panel that applies to every conversation on this machine, across all models.
Just like Codex's global AGENTS.md or ChatGPT's Custom Instructions, the notes and context you write in the "Custom Instructions" panel are automatically carried into every future conversation — no need to repeat yourself in every message.
Features
- Codex-style custom instructions: Settings → General → "Custom Instructions", edits
~/.dsh/AGENTS.md, saved straight to disk. - Applies to every session and every model: built on DSH's built-in
dsh-agent-instructionsmechanism — new conversations pick it up from the first message; the current conversation picks it up after the next file operation. - WYSIWYG: monospace editor mirrors the file content; saving gives immediate success/failure feedback.
- Zero build: hand-written
window.__ModuleLoader__.loadclient bundle + pure Node ESM host — no build authorization needed to install.
Install
From GitHub (this repo)
dsh plugin --profile web add github:lyke-61/dsh-custom-instructionsThen restart dsh web once so the bundle layer loads.
Manual (edit profile files)
1. Add the dependency:
// ~/.dsh/profiles/web/package.json
{
"dependencies": {
"dsh-custom-instructions": "github:lyke-61/dsh-custom-instructions"
}
}2. Add the plugin row (this repo ships its own cordis.patch.yml — either merge its row into your profile's cordis.patch.yml, or install via the dsh plugin command above which does it for you):
# ~/.dsh/profiles/web/cordis.patch.yml
- insert:
- id: custom-instructions
name: dsh-custom-instructions3. Run pnpm install in the profile directory, then restart dsh web.
How it works
| Layer | File | What it does |
|---|---|---|
| Host | lib/index.js | Registers GET/POST /custom-instructions routes on the webServer to read/write ~/.dsh/AGENTS.md; the path is resolved via @deepseek-ai/dsh-home-paths — the same file dsh-agent-instructions reads |
| Client | lib/client.js | Registers the "Custom Instructions" panel in the General settings slot (settings.general.item, id custom-instructions, right below "Permissions"); loads content via fetch on open, saves via POST |
| Bundle | cordis.patch.yml | The loader row that mounts both halves |
Effect mechanism: the panel edits the very global-instruction file dsh-agent-instructions injects into every session, so the plugin needs no hot-reload of its own — new sessions see it immediately; the current session picks it up after the next read / write / edit file operation.
Compatibility
- DeepSeek Harness
0.1.0-rc.6(web profile). - Depends on the built-in
dsh-agent-instructions(shipped with thestandardpreset by default); if your profile disables it, the instructions won't be injected.
Development
The client bundle is hand-written in the exact wire format (window.__ModuleLoader__.load({ id, factory })), so no build step is required:
node --check lib/index.js
node --check lib/client.jsLicense
MIT