GoodJob

Background jobs, waits, and agent operations for DeepSeek Harness.

GoodJob is an out-of-tree DeepSeek Harness plugin (a bundle). It gives you an IDE-style operations workspace over Jobs, durable Job Groups, Waits, recursive Subagents, and optional Agent Teams without creating a second scheduler, task board, event bus, transcript store, or conversation surface. Execution remains owned by the DSH capability that started it.

Install

npx -y @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:fentz26/dsh-goodjob

Then start the web profile as usual:

npx -y @deepseek-ai/dsh@0.1.1-rc.2 --profile web

Upgrade / uninstall:

npx -y @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web update dsh-goodjob   # upgrade in place
npx -y @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web remove dsh-goodjob   # uninstall

Requires Node ≥ 22.19 or ≥ 24, pnpm ≥ 10 on PATH, and Git (GitHub is reachable anonymously — this repository is public). GoodJob stores no credentials anywhere. Full installation mechanics: docs/installation.md.

Main features

• Operations workspace — a native conversation view with an Explorer, stable tabs, and up to four split panes over Jobs, Groups, Waits, Subagents, and Teams.
• Goals (docs) — the Session's durable objective with phases, rounds, and blocked reasons.
• Workflows (docs) — durable workflow runs and member outcomes, exactly as the tool records them.
• Schedules (docs) — durable reminders projected read-only with explicit overdue state.
• Needs Attention (docs) — deterministic blockers/failures derived from authoritative states, plus "Why idle?" on agents.
• What changed? (docs) — a deterministic since-last-visit delta from authoritative timestamps; only its presentation-local reference timestamp is stored.
• Operations search (docs) — live-preferred Session search through DSH's own query engine; no shadow index.
• Usage (docs) — exact token accounting from the durable tokenUsage projection; never a derived price.
• Artifacts (docs) — deferred until DeepSeek Harness exposes a deliverable authority.
• Jobs — live status, exact elapsed time, bounded searchable output; reading logs never advances the model-facing cursor.
• Job Groups — durable Session-local labels over existing Job ids with exact member states; a compact job_group tool for fan-out / fan-in.
• Waits — durable wait intents folded read-only from wait/change Session events.
• Subagents — every descendant with lineage, activity, model, related Jobs, and navigation actions.
• Agent Team (optional) — projects the Team roster, tasks, and mailbox when Agent Teams is composed.
• Settings → Plugins → GoodJob — visibility controls for every section on DSH trees that compose the settings registry.

Compatibility

Verified minimum: DeepSeek Harness 0.1.1-rc.2 — GoodJob installs, boots, and its core features work there; two capabilities degrade gracefully until upstream ships their seams. Details and known launcher issues: docs/compatibility.md.

Technical documentation

Document	Contents
docs/installation.md	prerequisites, what the installer does, auth behavior
docs/architecture.md	workspace, host half, model-facing tools, limitations, repository layout
docs/compatibility.md	capability matrix, graceful degradation, launcher issue
docs/workspace.md	workspace identity, persistence, projection, rendering reference
docs/development.md	local development against DSH sources

Security reports follow the coordinated process in SECURITY.md — please use GitHub Private Vulnerability Reporting or the contact address there; do not open public issues for unpatched vulnerabilities.

Contact

Questions and feedback: contact@fentz.dev

License

MIT