dsh-screenwrite
v1.6.3
Published
A five-element screenplay studio for DeepSeek Harness: a local script library, US Letter pages, PDF and Fountain export, and an agent writing into the same script.
Maintainers
Readme
Screenwrite · DSH plugin
English | 中文
A screenwriting desk for DeepSeek Harness: a local screenplay library, a US Letter page, autosave, and an agent writing into the same script.
Look for Screenwrite studio in the sidebar.
Install
Requires DeepSeek Harness. dsh-screenwrite is on npm: install it from the
Plugins page, and let that page update it.
From npm. Plugins page → 添加插件 → dsh-screenwrite, or:
install_bundle target: dsh-screenwriteThe bundle is saved as an exact version in ~/.dsh/profiles/<profile>/package.json,
and the Plugins page then lists newer releases with an Update button.
From a checkout. Link the folder instead:
{
"dependencies": { "dsh-screenwrite": "link:/absolute/path/to/dsh-screenwrite" },
"dsh": { "profile": { "bundles": ["…", "dsh-screenwrite"] } }
}cd ~/.dsh/profiles/<profile> && pnpm installA linked checkout gets no version list on the Plugins page; rebuild it and restart Harness to pick up changes.
Either way the package name, cordis.patch.yml's name, the id at the top of
client.js and the entry in dsh.profile.bundles have to agree — all read
dsh-screenwrite. The folder may be called anything.
Writing
- Five elements: scene heading, action, character, parenthetical, dialogue.
⌥1–⌥5(Alt+1–Alt+5) jumps straight to an element,Tabstill cycles,Entersplits,⌘Ssaves. - The scene rail follows the page as you scroll; click a scene to jump to it.
- Exports: PDF (renders in the browser, no print dialog), Fountain, plain text, standalone HTML.
- Scripts are JSON files in
~/.dsh/screenwrite/scripts/; nothing leaves the machine. An older~/.dsh/screenplay/library is moved over on first run. - A first run into an empty library seeds a short demo, Night Shift (
samples/), so the page has something on it.
Format
Fountain-like, one script per page, five elements:
Title: Night Flight
Author: Lin Xia
INT. COFFEE - DAY
Morning light through the blinds.
LIN XIA
(low)
He's late again.
INT. OFFICE - NIGHT
SARAH (V.O.)
We should go.Scene headings may be English or Chinese. Prefix a line with . for scene, @ for character, ! for action.
Agent
The plugin registers the screenwrite tool — list, read, create, write, append, rename, delete. Ask the agent to read the live script first and to describe edits scene by scene.
License
MIT
