@jasonqq/dsh-btw-plugin

A Codex-style /btw command for DeepSeek Harness.

/btw <question> answers a side question in a sub-context seeded with the main
conversation, and shows the answer in the chat without ever adding it to the
main conversation's model history. Ask "by the way…" questions freely — the
main context stays clean.

How it works

• The command is registered through @deepseek-ai/dsh-commands (the same
  registry that powers /compact, /goal, /plan).
• The question is delegated through ctx.subagents.start("fork", …). The
  fork provider spawns a child agent seeded with the parent's completed
  turns, so the side question is answered with full knowledge of the main
  conversation.
• The child's answer is returned as a plain command result. Command results are
  rendered by the UI adapter and never enter the model history — that is the
  "no pollution" guarantee.

Usage

In any session composer:

/btw <question>

The answer appears as a command result card. It does not become a message the
main model sees, so you can reference it yourself without bloating the context.

Install

The plugin ships as a Cordis plugin and plugs into any profile that mounts
@deepseek-ai/dsh-commands and @deepseek-ai/dsh-subagent (both are part of
the shipped @deepseek-ai/dsh-base composition).

1. Make the package resolvable from the profile, e.g. link it into the shared
   profile store:

   mkdir -p ~/.dsh/profiles/node_modules/@jasonqq
   ln -s "$PWD" ~/.dsh/profiles/node_modules/@jasonqq/dsh-btw-plugin

2. Add it to the profile patch layer (~/.dsh/profiles/<profile>/cordis.patch.yml):

   - insert:
      - id: btw
        name: @jasonqq/dsh-btw-plugin
        config:
          provider: fork

   The profile patch is read at boot. In the desktop app, restart the app
   after editing it (the CLI dsh web runner hot-reloads its patches).

Configuration

Development

npm test

The tests exercise the handler with a stubbed ctx.subagents seam — no live
model or host is needed.

License

MIT