DeepSeek Harness plugin

dsh-codex-sidebar

Codex-app-style 侧栏 for a DeepSeek Harness 主会话

Jump to install

Source facts

Repository
NOirBRight/dsh-codex-sidebar
Latest update
Aug 21, 2026
Category
Tools & Capabilities
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/NOirBRight/dsh-codex-sidebar
Plugin: dsh-codex-sidebar
Author: NOirBRight

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only
README language

dsh-codex-sidebar

English | 中文

A Codex-app-style right-hand sidebar for one DeepSeek Harness session. Files, Review, Browser, and Terminal share a tab strip on the current session.

![Conversation plus Files preview in the sidebar](docs/screenshots/01-overview.png)

What it does

Open a session, then use the sidebar toggle in the conversation header. The drawer occupies the details column of the DSH frame. It does not replace the chat.

  • Files — read-only preview (source, Markdown, images) and a workspace tree. Click a path in the transcript to fill it.
  • Review — this turn's changes from the session log, then leftover working-tree diffs. Read-only: no stage, revert, or commit.
  • Browser — a managed Chromium document in that tab. The session can call browser_tabs, browser_open, browser_snapshot, browser_click, and browser_fill on loopback HTTP pages whether the sidebar is open or closed. Idle tabs are closed; opening the DSH web GUI inside this browser is rejected.
  • Terminal — a human pty (script when present), not an agent shell.
  • Annotations — click a line or a page to write a note at the mark. Send keeps the official user bubble; numbered chips sit under it. Locators and screenshots go to the model as evidence on that same user message.
  • Edit +/− — each edit/write tool row shows the increment for that call, after the filename.

![Review of this turn's changes with per-file +/−](docs/screenshots/03-review.png)

Chrome follows the DSH host theme. Tabs persist with that session. Side Chat is retired; cross-session questions belong to the DeepSeek assistant's task-reference flow.

![Browser empty state](docs/screenshots/04-browser.png)

![Human terminal](docs/screenshots/05-terminal.png)

![Empty-tab palette](docs/screenshots/06-palette.png)

Installation

DeepSeek Harness 0.1.0-rc.6 or later. Install from GitHub:

dsh plugin --profile web add github:NOirBRight/dsh-codex-sidebar#v0.3.5
dsh web

Lab (DSH_HOME=~/.dsh-lab) uses the same package name:

DSH_HOME=~/.dsh-lab dsh plugin --profile web add github:NOirBRight/dsh-codex-sidebar#v0.3.5

The repository tracks release-ready lib/ artifacts, so GitHub installation needs no build-script allowlist.

Since 0.3.0, Review/Files workspace projection is asynchronous and demand-driven: a collapsed sidebar does not scan git, Review rows use summaries, and file details load only when opened. Sidebar state is isolated under DSH_HOME, with on-demand fallback migration from ~/.dsh-codex-sidebar/sessions. Very large or binary file details are bounded summaries rather than unbounded LCS diffs, so the host remains responsive.

Do not list @deepseek-ai/dsh-tools (or other host singletons) as a plugin dependency. A hoisted copy shadows the host ToolRuntime and every tool call dies on .prepare.

Local install

pnpm install
pnpm test
pnpm run build
dsh plugin --profile web add "$(pwd)"
dsh web

Then open a session and use the sidebar toggle.

Spec

See CONTEXT.md and docs/adr/.