dsh-process-console
Processes tab for DeepSeek Harness: every agent and subagent of a conversation as a live console with paired tool requests and responses, installed as one profile bundle.
- Stars
- 0
- Language
- TypeScript
- Created
- Sep 5, 2026
- Updated
- Sep 6, 2026
Introduction
dsh-process-console
A Processes tab for the DeepSeek Harness web UI: every agent and subagent of a conversation as a live console, with the exact request and response of each step.
The tab sits next to Chat and Trajectory. It lists every process of the current conversation, the main agent and each subagent under it, and prints the selected one as a live console: what the agent wrote, every tool request with its raw arguments, every tool response with its full content, the model behind each step, timing, errors and pending approvals.
Works on the published harness. No patch, no fork, no modified checkout. This is an independently maintained SoftSpark community integration. It is unofficial and is not affiliated with or endorsed by DeepSeek.
What's New in v1.0.0
- Processes tab with a process tree and a live per-process console, paired tool requests and responses with elapsed time.
- External delegations (Claude Code, ACP agents) as nested rows with their own console when the harness records
subagent/streamevents. - The harness-side change shipped as a reviewed patch set in
patches/dsh-0.1.1-rc.2/, pending upstream.
Full history in CHANGELOG.md.
Contents
- Why
- Requirements
- Install
- Update
- What you see
- External delegations
- Documentation
- Contributing
- Security
- License
- Changelog
Why
Chat shows the conversation. Trajectory shows one session's ledger. Neither answers the question "what is each process doing right now, with which exact request and which exact response". When a parent delegates to subagents the picture splits across sessions you have to open one at a time. This tab puts them side by side and keeps following the tail.
Requirements
- Node.js 22.19.0 or newer
- DeepSeek Harness
0.1.1-rc.2 pnpmfor the profile plugin manager
Install
dsh plugin --profile web add @softspark/dsh-process-console --save-exact
Restart DSH. The package registers its row itself. For a local checkout:
pnpm install --ignore-scripts && pnpm run build
dsh plugin --profile web add "$(pwd)"
Update
Pins are exact on purpose. Move to a newer release by adding it again, then restart DSH:
dsh plugin --profile web add @softspark/dsh-process-console@<version> --save-exact
dsh plugin --profile web remove @softspark/dsh-process-console removes the tab and nothing else.
What you see
| Column | Content |
|---|---|
| Process tree | The current session as main, then every session-backed subagent under it, nested by delegation depth, with a running or idle marker. |
| Console | One line per event in log order. USER, CTX, STEER, THINK, ASSIST (provider/model, turn, step, time to first token, total, tokens), CALL (tool name and pretty-printed arguments), RESULT (full content, elapsed time since the call, error code), RUNNING, STREAM, WAIT, SYS, ERROR. |
| Toolbar | Substring filter, load older history, raw JSON for every line, follow-tail toggle. Scrolling up pauses following; the toggle resumes it. |
| Per line | Copy the body, or expand the raw payload of that one line. Long bodies start collapsed at 30 rows. |
Tool calls include MCP tools, since the harness records them as ordinary tool events.
External delegations
One-shot external delegations (subagent_claude_code, subagent_gemini_copilot) have no session of their own, so a stock harness records only their final answer: they appear as a CALL and a RESULT in the parent console.
With the harness-side change described in kb/reference/subagent-stream.md, the provider appends the child's steps to the parent log as ignorable subagent/stream events, and this tab folds them into a nested row per child with its own live console. The change is four small patches on published 0.1.1-rc.2 packages (dsh-session, dsh-subagent, dsh-subagent-claude-code, dsh-subagent-acp), shipped by dsh-drydock from 1.27.0 and proposed upstream in a GitHub Discussion, since the harness takes neither external pull requests nor issues yet. Without it the tab behaves exactly as before.
Documentation
| Document | Purpose |
|---|---|
| Architecture | The slot, the data path and why the package is standalone |
| Security model | What the tab can and cannot read |
| Setup | Install and confirm |
| Common issues | Why the tab is missing or a pane stays empty |
| Implementation plan | Scope, success criteria, pre-mortem |
Contributing
See CONTRIBUTING.md. pnpm run verify is the gate.
Security
The tab is read-only and adds no host surface; the model is in SECURITY.md and kb/reference/security.md.
License
Apache-2.0. See LICENSE and NOTICE.
Changelog
Every release is recorded in CHANGELOG.md.
Built by SoftSpark for people who want to see what their agents actually do.