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-instructions mechanism — 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__.load client 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-instructions

Then 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-instructions

3. 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 the standard preset 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.js

License

MIT