dsh-job-log
Manifest validDeepSeek Harness (DSH) plugin: live background-job terminal output with clickable job ids.
Job output
A DSH Web plugin that adds a live background-job terminal tab and makes job ids clickable.
Why
job_output is a model-facing read: it advances the model's own cursor and is
not a terminal. Watching a long-running background job from the Web UI should
not require asking the model to read it again. This plugin gives the human a
live view and keeps the model's cursor untouched.
Features
- Job tab (
conversation.viewidjob-log, order 20) beside Trajectory and Statistics; labels areJob/Задание. - Live output through the client-only
ctx.jobsservice:watchRows(sessionId),observe(sessionId, jobId),kill(sessionId, jobId). - Clickable job ids in the
job_output,job_list, andjob_killtool cards. A click selects that job in the Job tab. - Job list with search across running and finished jobs; running jobs are listed first.
- Status, duration, command, exit code / detail, and a monospace output block.
- Autoscroll with a pause when the reader scrolls up, plus Jump to latest.
- Copy the command and the output.
- Two-step stop for a running job: arm, then confirm within three seconds.
- Empty, loading, unknown-id, retention-gap, stream-error, and host-restart states without crashing.
ru/endictionaries and native keyboard-focusable controls.
Install
The repository is a DSH bundle: package.json declares dsh.bundle.patch and
dsh.client, and the patch inserts one loader row.
plugin_manager action=install_bundle target=/absolute/path/to/this/repository
For a local profile, that adds @local/job-log and the job-log row. Restart
or refresh the Web page if the tab does not appear immediately.
The host half is a no-op; the browser module is client.js. The package name
stays @local/job-log; the plugin row id is job-log.
Releases
Tags vX.Y.Z trigger
.github/workflows/release.yml. The workflow
runs npm run check, packs the bundle with npm pack, renames the tarball, and
creates a GitHub Release with generated notes and the .tgz asset.
Install a release:
- from the release asset: download
dsh-job-log-X.Y.Z.tgzand runplugin_manager action=install_bundle target=/absolute/path/to/dsh-job-log-X.Y.Z.tgz; - or by tag, for a public repository:
plugin_manager action=install_bundle target=git+https://github.com/Sect0R/dsh-job-log.git#vX.Y.Z.
DSH Plugin Manager does not auto-update local, git, or tarball installs; install the new release manually. Only registry (npm) installs get the built-in version list and Update action.
See CHANGELOG.md for release notes.
Use
- Start a long-running background job from a session.
- Open the Job tab. The list shows the session's jobs.
- Click a
job_idin ajob_output/job_list/job_killcard to open the tab with that job selected. - Use the search field to filter the list if the tab was opened manually.
- Watch the output stream; scroll up to pause autoscroll, then use Jump to latest.
- Stop a running job with Stop, then Confirm stop.
If the tab is folded into the header's More menu, the card's job id can still select the job after you open the tab manually; the selection is kept in the plugin and in the conversation store's view request.
How it works
client.jsregisters theconversation.viewentry and the threetool.call.toolviewoverrides at priority-10(the slot election renders the lowest priority, so the plugin's cards replace the shipped job cards).- The view consumes
viewRequest, selectsviewRequest.focus, and callscompleteViewRequest()after applying it. - A card click tries three navigation paths, best first:
- the live per-session Conversation store's
openViewaction (the same action the shell uses); - the shell's
openViewcallback captured when the Job view last rendered; - a tab-button click (and the More menu path) after recording the pending job, which the view reads on mount.
- the live per-session Conversation store's
- The first path reads the registry's cached
conversation.sessionstore instance. That is a best-effort internal lookup, guarded and backed by the fallback paths. - Trajectory, Statistics, Chat, and the other tool cards are not modified.
Compatibility
- DSH Web
0.2.2-rc.1(the version this plugin was built and verified against);engines.dshis^0.2.2-rc.1. - Client services used:
jobs,slots,locale,uiConversation. - No model-facing tool, prompt, session event, or cursor is added or changed.
Limitations
- The Job tab is browser UI only; terminal ANSI control sequences are stripped for readability, so colors are not reproduced.
- The tool cards intentionally show a compact recorded result; the full live stream stays in the Job tab.
- The store lookup in step 1 of the navigation is implementation-specific. If a future DSH build changes that registry, the tab-button fallback still navigates; a card may then show a hint to open the tab manually.
- A host restart can drop the job ring; the tab then shows an empty or not-found state with a restart hint.
Development
No build step is required: client.js is the browser module, and index.js is
the no-op host half.
npm run check
Then install the directory as a local bundle and exercise the tab/card paths in
the running Web GUI. The plugin manager row is job-log.
Repository files:
| File | Role |
|---|---|
client.js | Browser module: dictionaries, styles, view, tool cards, navigation |
index.js | Host half: no-op loader row |
cordis.patch.yml | Bundle patch inserting the job-log row |
icon.svg | Plugin Manager icon |
assets/ | Logo, icons, and the social preview |
locale/ | Plugin Manager title/description (en, ru) |
CHANGELOG.md | Release notes |
.github/workflows/release.yml | Tag-driven pack and GitHub Release |
Discoverability
This repository is meant to be found through the GitHub topic
dsh-plugin. Topics and the social
preview are public-repository surfaces:
- Add topics in the repository's About section (the gear icon) —
dsh-plugin,deepseek-harness,dsh. Topics on a private repository are not publicly discoverable. - Set the social preview under Settings → General → Social preview using
assets/social-preview.png(1280 × 640, under 1 MB). GitHub exposes this setting for public repositories, or for private repositories that already have an uploaded image; a new private repository does not show it. - GitHub repositories do not have a separate avatar — the repository page shows
the owner's avatar.
assets/icon-128.pngis the DSH Plugin Manager icon, not a GitHub repository avatar.
Suggested repository description:
DSH Web plugin: live background-job terminal output with clickable job ids.
License
MIT. See LICENSE.
Comments
Loading…
Similar plugins
by gorban
DeepSeek Harness (dsh) plugin: stop a running background job from the session-header job list, behind a confirmation dialog.
★ 1
↓ 276/wk
MIT
TypeScript
Sep 20, 2026
dsh plugin --profile web add @gorban/dsh-job-stopby XiaoWind
DeepSeek Harness plugin: portable workspace vault for DSH conversations and logs
★ 0
MIT
JavaScript
Sep 30, 2026
dsh plugin --profile web add dsh-vaultby G57651
One DeepSeek Harness plugin that checks in Trae and WorkBuddy from local login files only. The two platforms run independently and do not block each other.
★ 3
MIT
JavaScript
Oct 25, 2026
dsh plugin --profile web add dsh-dual-checkinby Stijnus
Live task-board plugin for DeepSeek Harness Web: sidebar badge, full-shell kanban with search, filters, export, and diagnostics.
★ 0
MIT
TypeScript
Sep 2, 2026
dsh plugin --profile web add dsh-ds-kanbanby yangbobo2021
Workspace file explorer side-view plugin for DeepSeek Harness Workbench.
★ 0
MIT
JavaScript
Sep 3, 2026
dsh plugin --profile web add relay-dsh-plugin-filesby Momojie-S
DSH plugin: per-workspace .env injection for shell subprocesses
★ 2
MIT
JavaScript
Oct 10, 2026
dsh plugin --profile web add @momojie-s/dsh-workspace-env