DSH Codex UI

Organize projects, find conversations, and revisit long chats more easily in DSH Web

简体中文 · Changelog · Apache-2.0

DSH Codex UI is a community-maintained interface plugin for DeepSeek Harness (DSH), not an official DeepSeek AI product.

Working across several projects and conversations in DSH Web? DSH Codex UI helps you organize the sidebar, find tasks quickly, and jump back to earlier questions in long chats. It offers a Codex-style interface with light and dark themes.

Host compatibility

This working tree explicitly declares DSH 0.1.2-rc.1, 0.1.5-rc.1, 0.1.5-rc.2, 0.1.5-rc.3, 0.1.7-rc.1, 0.1.7-rc.2, 0.2.0-rc.1, and 0.2.0-rc.2. Development dependencies are pinned to 0.2.0-rc.2. No code references @deepseek-ai/dsh-client-runtime: it is not a peer, not a client inject, and no longer a development dependency now that the settings-lifecycle spec mounts the production SlotRegistry from the official @deepseek-ai/dsh-client-ui-renderer/client bundle. Isolated host checks cover 0.1.2-rc.1, 0.1.5-rc.1, 0.1.5-rc.2, 0.1.5-rc.3, 0.1.7-rc.1, 0.1.7-rc.2, 0.2.0-rc.1, and 0.2.0-rc.2.

What you can do

• Organize projects and conversations: expand or collapse projects, drag to reorder, pin frequently used projects, and see unread and running indicators.
• Find things quickly: search for conversations, settings, and quick actions from the header.
• Manage everyday tasks: rename, archive, or fork conversations, and open project folders from their menus.
• Revisit long chats: select a turn marker to jump directly to the corresponding question.
• Reuse earlier input: press Up/Down in an empty composer to recall text submitted in the current workspace.
• Add features as needed: check companion plugins in Settings → About and install or update the ones you need.

Screenshots

Light theme: workspace tree, new conversation suggestions, and bottom composer.

Dark theme: scheduled task overview and new conversation page.

General settings: dedicated settings page with section navigation in the light theme.

Conversation menu: rename, pin, unread, archive, fork, copy, and delete.

Settings → About lists the companion plugins and their install state.

Prerequisites

• A working DeepSeek Harness Web installation with dsh available in PowerShell.
• Examples use the web profile; replace it with the target profile.
• Node.js must satisfy ^22.19.0 || >=24.0.0. Installing from source also requires pnpm.

DSH product ecosystem

For a desktop workbench, download DSH Codex Desktop. Existing DeepSeek Harness installations can add plugins as needed by following each project's README. Below are 11 first-party plugins; consult the corresponding desktop release notes and bundled catalog for what that version includes.

Installation

Choose agent-assisted or manual installation below. Both use the same command, requesting the latest version from the official npm registry.

Ask an agent to install it (recommended)

Send the prompt below to any agent that can run terminal commands on your computer. Replace web with your actual profile. Once installed, use the plugin in DSH.

Install the DSH plugin @michengai/dsh-codex-ui into my local web profile by running: dsh plugin --profile web add @michengai/dsh-codex-ui@latest --registry=https://registry.npmjs.org/. Then run dsh --profile web --dump-config, confirm the configuration includes codex-ui, and explain how to reload DSH and start using the plugin.

Install manually

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
dsh plugin --profile web add @michengai/dsh-codex-ui@latest --registry=https://registry.npmjs.org/
dsh --profile web --dump-config

Restart DSH Web and hard-refresh the browser (usually Ctrl+Shift+R). Once the new sidebar appears, you are ready to use it. Disabling or uninstalling restores the official sidebar. If the profile cordis.patch.yml still has disabled: true for ui-sidebar or ui-settings-general, delete those rows and reload.

Usage

Open DSH Web. The left navigation is rendered by this plugin.

FAQ

Do pinned projects and unread markers persist?

Pinned projects are saved in your DSH configuration and survive restarts. Unread markers are stored only in the current browser and do not sync across browsers.

Why is my earlier input missing?

Input history is stored in the current browser, separately for each workspace, with up to 200 entries per workspace. It records new input while the feature is active and does not import existing conversations. When browser storage is unavailable, history is kept temporarily in memory. The BTW plugin is not required.

Does removing a project delete local files?

Removing a workspace registration does not delete its folder or conversation records. Permanent deletion of archived conversations is provided by the companion Archive Manager plugin.

What if nothing changes after installation?

Check that the installation profile matches the one running DSH Web, then restart DSH Web and hard-refresh the browser. Run dsh --profile web --dump-config to check that codex-ui is mounted.

Development and contributing

GitHub and npm both include a ready-to-run lib. After changing source, run pnpm build before committing.

Install from source

Use this for debugging or unpublished changes. The cloned directory becomes the plugin source path:

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
Set-Location D:\Repository\deepseek-harness-plugin
git clone https://github.com/MichengAI/dsh-codex-ui.git
Set-Location .\dsh-codex-ui
pnpm install --frozen-lockfile
pnpm build
dsh plugin --profile web add .
dsh --profile web --dump-config

Restart DSH Web and hard-refresh the browser. Do not copy lib manually; local installation reads both package metadata and cordis.patch.yml.

• src\index.ts: host entry and the non-sensitive Connectors directory endpoint.
• src\client\index.ts: client entry for sidebar, workspace tree, turn navigation, and Settings sections.
• src\client\CodexSidebar.tsx: sidebar shell, search panel, and visual styles.
• src\client\CodexWorkspaceBrowser.tsx: workspace and conversation interactions.
• tests\*.assert.ts and tests\*.spec.ts: interaction, visual, and runtime integration checks.

After changing src, rebuild, test, and install from the local directory:

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
pnpm build
pnpm test
dsh plugin --profile web add .

New features should reuse existing DSH slots and public services. Do not depend on private host DOM or write conversation records.

License

This project is licensed under Apache License 2.0.