Introduction

Below is an introduction to @kanonouta/dsh-captain. It is a DeepSeek Harness (DSH) plugin that exposes a synthetic captain model route: GPT is responsible for planning and independent review, while DeepSeek workers execute incremental repository changes.

What is it

@kanonouta/dsh-captain is maintained by KanoNoUta and is licensed under MIT.

It provides a captain route that breaks down tasks into three roles:

  1. GPT planner returns a JSON dependency DAG.
  2. DeepSeek workers execute under configured token budget and adaptive parallel limits.
  3. An independent GPT reviewer reviews based on acceptance criteria, worker reports, and incremental Git diff.

The plugin supports a dual bundle for Host plugins and browser/client settings cards, and provides a configuration card at Settings -> Plugins -> Captain.

Core Features

captain Route

The plugin exposes a synthetic captain model route. Once configured, this route is used to orchestrate the planning, execution, and review processes.

Planning and Execution

The GPT planner returns a JSON dependency DAG. DeepSeek workers execute under configured token budget and adaptive parallel limits.

maxAgents is a ceiling, not a fixed fan-out; maxParallel: 0 uses an adaptive ceiling.

Independent Review

An independent GPT reviewer reviews based on acceptance criteria, worker reports, and incremental Git diff.

Git reviews run from the cwd of the parent Agent Session; if workspace metadata is missing, the incremental diff is reported as unavailable.

Image Attachments

The plugin supports ImageAttachmentRef attachments and converts them to text notes via a dedicated vision route.

If the selected model explicitly only supports text input, Captain will attempt to select an image-capable model from the same provider, prioritizing Terra followed by Luna; if no image model is declared, it will fail before dispatch.

Vision calls omit reasoningEffort.

Credentials

The plugin does not implement OAuth or a second set of credential stores. Relay providers need to be configured in the standard LLM settings.

Installation and Enablement

  1. Execute the installation command in the Web profile:
dsh plugin --profile web add github:KanoNoUta/dsh-captain

  1. Open Settings -> Plugins -> Captain to configure the planner, worker, reviewer, vision, policy, reviewer toggle, and orchestration settings.

  2. Configure the required relay providers in the standard LLM settings.

Typical Usage

Configuration Example for planner, worker, and reviewer

The example configuration uses the following provider, model, and reasoningEffort:

planner:
  provider: gpt-relay
  model: gpt-5.6-sol
  reasoningEffort: max

worker:
  provider: deepseek-official
  model: deepseek-v4-flash
  reasoningEffort: high

reviewer:
  provider: gpt-relay
  model: gpt-5.6-terra
  reasoningEffort: ultra

This snippet only lists the provider, model, and reasoningEffort for the planner, worker, and reviewer. Vision, policy, reviewer toggle, and orchestration settings need to be configured in the settings card.

Gateway Model Input Declaration

For gateway models in the llm-pi-ai provider profile that are missing built-in directories, you need to declare image input:

input: [text, image]

Use Cases and Notes

Based on verified facts, it is suitable for the following use cases:

  • Need to use a captain route in DSH instead of configuring a single model.
  • Need a division of labor involving GPT planner, DeepSeek workers, and an independent GPT reviewer.
  • Need to convert ImageAttachmentRef attachments to text notes for subsequent planning and execution.
  • Need to centrally configure planner, worker, reviewer, vision, policy, reviewer toggle, and orchestration settings in Settings -> Plugins -> Captain.

Notes:

  • The plugin runs with the permissions of the current dsh process; you should check the source code and license before installing.
  • The license is MIT.
  • The plugin does not implement OAuth or a second set of credential stores; relay providers must be configured in the standard LLM settings.
  • Worker execution failures will stop before review and repair.
  • Git reviews run from the cwd of the parent Agent Session; if workspace metadata is missing, the incremental diff is reported as unavailable.

Links

  • GitHub: https://github.com/KanoNoUta/dsh-captain
  • Directory Page: Not provided.