DSH Codex UI

Rebuild the DeepSeek Harness Web sidebar, workspace tree, search, and turn navigation in a Codex-style layout

简体中文 · Changelog · Apache-2.0

DSH Codex UI is a community-maintained DeepSeek Harness (DSH) plugin, not an official DeepSeek AI product. It uses public DSH slots only and does not modify host source code or conversation data.

Features

• Replace the default sidebar through the official sidebar slot and keep sidebar.workspaces, sidebar.settings, and sidebar.footer.action.
• Provide a Codex-style header with brand wordmark, sidebar collapse, and global search.
• List workspaces and conversations with expand/collapse, drag reorder, project pinning, unread dots, and running-state indicators.
• Add project and conversation menus for rename, pin, unread, archive, fork, open folder, copy, and delete.
• Restyle the conversation column and composer card, and add a compact turn navigator on the current session.
• Show companion-plugin status in Settings → About, and install the missing pieces from npm.

Screenshots

Light theme: Codex-style sidebar, workspace tree, and conversation column.

Dark theme: the same layout with Codex dark tokens.

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.
• Source installation and development require Node.js 22+ and pnpm. Installing from npm does not require running pnpm install in an arbitrary directory.

Plugin combo

@michengai/dsh-codex-suite-installer is the lightweight one-click installer for the @michengai/dsh-codex-suite member set. It adds these six plugins to the same profile as direct dependencies:

dshmarket stays optional. When it is installed, Plugins opens the market first.

Direct dependencies let Settings → About detect and update every plugin independently. The lightweight installer carries only the version manifest, and it migrates the legacy aggregate Suite without leaving duplicate patches behind.

DSH product ecosystem

Codex UI can be installed independently or used through the desktop app or Web suite. They share the same DSH core but serve different ways of working:

Installation

dsh plugin add forwards to pnpm add in the profile directory. Without a version and official registry, a local mirror or minimum-release-age policy can leave you on an older build.

Ask another agent to install the suite

Copy one of the sentences below into DSH, Codex, or WorkBuddy and let that agent install the combo into your local web profile.

From npm:

Use the one-click installer to add all six DSH Codex Suite members as direct dependencies of my local web profile: npx --yes @michengai/dsh-codex-suite-installer@latest --profile web. Confirm its configuration check succeeds, then remind me to restart DSH Web and hard-refresh the browser.

UI only:

Install the latest DSH plugin @michengai/dsh-codex-ui into my local web profile using the official npm registry: dsh plugin --profile web add @michengai/dsh-codex-ui@latest --registry=https://registry.npmjs.org/. Then run dsh --profile web --dump-config, confirm codex-ui is mounted, and remind me to restart DSH Web and hard-refresh the browser.

The installer needs the current dsh on PATH. Set DSH_BIN when the executable lives elsewhere.

Install the complete suite

This is the one-click combo. Run it from any PowerShell directory:

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
npx --yes @michengai/dsh-codex-suite-installer@latest --profile web

The installer reads its exact verified member versions, adds all six members as direct profile dependencies in one dsh plugin add, and finishes with dsh --profile web --dump-config. Replace @latest with an installer version to pin the whole set.

Restart DSH Web and hard-refresh the browser. Existing members are aligned in place; a legacy @michengai/dsh-codex-suite aggregate dependency is removed only after all six direct members have been staged.

Use the same command with another profile name for a clean custom Web profile:

npx --yes @michengai/dsh-codex-suite-installer@latest --profile codex

The installer stays in the current DSH_HOME and places DSH's built-in @deepseek-ai/dsh-web-app before the member bundles. It neither creates a separate Home nor reinstalls the official Web package.

Install Codex UI only

[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

The plugin takes over the default sidebar through cordis.patch.yml. Uninstalling restores the default sidebar.

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 dist manually; local installation reads both package metadata and cordis.patch.yml.

Usage

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

Deleting a workspace registration does not delete its folder or conversation records. Pinned and unread state is stored only in the current browser.

Persistence and safety limits

• The plugin uses only public DSH slots and services.
• It does not modify host source code or the conversation data model.
• Permanent deletion of archived conversations is provided by @michengai/dsh-archive-manager.
• The Connectors directory never exposes addresses, commands, or credentials.

Secondary development

• 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.

Verification

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
pnpm build
pnpm test

License

This project is licensed under Apache License 2.0. Conversation-management workflow is informed by Semidia/dsh-session-manager, but this plugin is implemented independently through public DSH slots and services.