Rebuilds the DeepSeek Harness web sidebar, workspace tree, search, and turn navigation in a Codex-style layout.
Install
# from npm (prebuilt)
dsh plugin --profile web add @michengai/dsh-codex-ui
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:MichengAI/dsh-codex-ui
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
DSH Codex UI v2.0
Modern Interface Suite for DeepSeek Harness: Rapid Input Recall, Full-Screen Settings Skin, Native Physical Glass Themes, and Modular Sidebar
简体中文 · English · 日本語 · Español · Français · Deutsch · Русский · Português
Notice: DSH Codex UI is a community-maintained interface enhancement suite for DeepSeek Harness (DSH), not an official DeepSeek AI product.
Why Codex UI 2.0?
When working across complex projects in DeepSeek Harness, users often encounter cramped settings modals, plain monocolor palettes, unstructured sidebars, and lost prompt history. Codex UI 2.0 rearchitects the entire frontend experience through six decoupled sub-plugins and built-in companion management, delivering a high-performance, non-intrusive, native-grade modern design:
- 🚀 Instant Prompt Recall & Smart Prediction: Intelligent inline input prediction (
Tabto accept,Alt+Down/Upto cycle), terminal-style input history (↑/↓quick recall) with conversation- or workspace-scoped memory and adaptive width sizing; - 🪟 Full-Screen Dual-Island Settings: Replaces cramped dialogs with Ambient Ground diffuse lighting canvas and dual floating island cards;
- 🎨 Native Physical Glass Themes: 14 built-in high-quality color schemes (featuring Codex, Claude, Dracula, Cyberpunk, Solarized, Gruvbox, and Catppuccin series), dual layout modes (Stock Flat vs. Mica Floating), 3-tier material presets, and ground glow switch;
- 🧭 Modular Dynamic Sidebar: In-place smooth accordion drawer and fluid drag-and-drop reordering; 100% aligned with host official 56px native rail when collapsed, keeping all icons crisp and New Session permanently visible;
- 🧠 Intelligent Session Titles: Semantic understanding of initial user prompts, supporting 4096-token reasoning model contexts;
- 🌐 Full Official Multilingual i18n Support: Native localization across all 8 official DeepSeek Harness languages (
zh,en,ja,es,fr,de,ru,pt) for starter suggestions, settings workbench, context menus, and session titles; - 🖥️ Desktop Native Menus: Injects a clean Help menu into the official desktop app titlebar, supporting native page reload and reliable cross-platform app/Host restart;
- 📦 Ecosystem Companion Hub: Centralized inspection, version checking, and 1-click batch upgrades for all official and third-party companion plugins.
Architectural Evolution: Why a Ground-Up Rewrite?
1. The Legacy 1.x Dilemma: Technical Debt of Forceful Component Overrides
In the early days of the DeepSeek Harness (DSH) plugin ecosystem, host frontend extension infrastructure was still nascent: fine-grained Slots registries were absent, official headless primitive libraries were unavailable, and plugin lifecycle hooks were sparse. To deliver a sleek, Codex-style immersive experience rapidly, legacy 1.x had to rely heavily on invasive component overriding: forcefully hijacking host DOM elements, injecting high-specificity CSS stylesheets, and hardcoding global CSS variables.
The Inevitable Maintenance Bottleneck: As official DSH iterated rapidly (introducing profile multi-environment isolation, shortcuts service gating, standard Slots registries, and the official primitive suite @deepseek-ai/dsh-client-ui-primitives), the technical debt of "forceful overrides" escalated dramatically:
- 💥 Extremely Brittle Compatibility: Any subtle DOM change or build-hash class update in upstream DSH would instantly break CSS overrides or cause full-page rendering crashes, stalling updates;
- 🎨 Style Bleed & Half-Degradation Trap: Injected global CSS tokens lacked clean lifecycle boundaries. Toggling off a theme failed to purge root attributes, resulting in awkward "half-degraded" states where glass effects vanished but hardcoded dark backgrounds lingered;
- 🧩 Broken Lifecycles & Zombie Settings: When a sub-feature was disabled, overridden views could not cleanly fall back to host native interfaces, leaving inert, non-functional configuration controls stuck in the settings modal.
2. The 2.0.0 Rearchitecture Decision: Fully Embracing Host Natives
Faced with these compounding challenges, we made the decisive choice in v2.0.0 to completely scrap all 1.x component override code and establish a new baseline: zero-intrusion, micro-kernel decoupling, and native-first engineering:
- 🏛️ Strict Adoption of Official Primitives & Slots: Prohibited custom hand-drawn CSS widgets; strictly leveraged official
Switch,SegmentedControl, andButtonprimitives. When collapsed, the sidebar strictly aligns with the official 56px native icon rail; - 🧩 Six Decoupled Micro-Kernel Sub-Plugins: Broken down into 6 self-contained, high-cohesion sub-plugins and built-in modules with explicit boundaries, enabling independent lifecycle management and streamlined code audits;
- 🛡️ Fail-Closed Circuit Breaker & Adaptive UI: Implemented strict fail-closed safety contracts. When a sub-plugin is disabled or unreachable, the runtime physically cleanses all injected tokens/root attributes, while the settings UI completely hides the defunct card (0 DOM nodes), reverting instantly to pristine host defaults without visual clutter;
- 🔒 Authoritative Profile Isolation & Self-Healing: Unambiguous Profile directory resolution eliminates cross-profile contamination, backed by window-focus self-healing probes for resilient network handling;
- 🎨 Authentic Codex Tech Aesthetic: Purged legacy green color pollution, strictly adhering to
#339cfftech-blue, minimalist paper, and charcoal dark tones with dual layout modes and ambient ground reflection glows.
Architecture: 6 Core Sub-Plugins & Built-in Modules
| Sub-Plugin ID | Name | Capabilities |
|---|---|---|
composer |
Composer Enhancement | Smart inline input prediction (Tab to accept, Alt+Down/Up to cycle), terminal-style input history (↑/↓), conversation- or workspace-scoped storage, dual drag-resize handles, and contextual prompt hints. |
settings-skin |
Native Settings Skin | Full-screen workbench layout, dual floating island system, Ambient Ground lighting canvas, and native search. |
theme |
Theme & Glassmorphism | 14 built-in themes with Appearance Cubes, Stock Flat vs. Mica Floating modes, 3 material presets, and ground glow switch. |
sidebar |
Modular Sidebar | Workspace sections (including direct "Add workspace" buttons on section headers, auto-shown when host directory-picking is available, placing new workspaces straight into the section), in-place accordion expansion, smooth drag-and-drop reordering, and right-click “mark as unread / read” for sessions; collapses cleanly into host native 56px icon rail. |
session-title |
Intelligent Session Title | Generates standardized session titles from initial prompt semantics, handling reasoning model outputs up to 4096 tokens. |
desktop-menu |
Desktop Native Menus | Official desktop app titlebar menu integration with instant view reload and reliable cross-platform app/Host restart. |
dependencies |
Companion Management (Built-in) | Centralized dashboard for official/third-party DSH companion plugins with live npm download counts and 1-click updates. |
Live Screenshots
All screenshots are captured directly from live DeepSeek Harness Web runtime environments using
ego-browser.
1. Immersive Workspace & Composer (Dark Mode)
Codex Dark palette with centered hero actions, prompt cards, and bottom composer with adaptive resize handles and ↑↓ history hints.

2. Paper Minimalist Workspace (Light Mode)
Codex Light palette powered by Ambient Ground diffuse lighting gradient, delivering organic warmth and eye comfort.

3. Full-Screen Dual-Island Settings (Modular Card System)
Spacious settings workbench organized into a modular card system (Feature Overview, Theme & Glassmorphism, and Companion Plugins), dynamically adapting based on active sub-components.

4. Theme Customization & Glassmorphism
14 built-in high-quality theme palettes and 1 official default option (covering Codex, Claude, Dracula, Cyberpunk, Solarized, Gruvbox, and Catppuccin series). Supports both Stock Flat and Mica Floating layout modes, 3-tier material presets (Clear, Standard, Frosted), and ground reflection toggle. Built on pure Design Token dynamic injection with clean lifecycle destruction, eliminating global style contamination.
Built-in Themes & Color Schemes
| Series | Theme Name | ID | Mode | Visual Style | Core Palette (Accent / Base BG / Text) |
|---|---|---|---|---|---|
| Official | Official Default | stock |
Auto | System default | Accent: #3b82f6 (Follows host system light/dark, zero custom tokens) |
| Codex | Codex Dark | codex-dark |
Dark | Immersive carbon dark | Accent: #339cff · BG: #09090b · Text: #fafafa |
| Codex Light | codex-light |
Light | Clean paper light | Accent: #0169cc · BG: #ffffff · Text: #18181b |
|
| Claude | Claude Dark | claude-dark |
Dark | Warm dark & terracotta | Accent: #d97757 · BG: #141414 · Text: #fdfdfd |
| Claude Light | claude-light |
Light | Warm paper & terracotta | Accent: #d97757 · BG: #faf9f5 · Text: #1f1e1d |
|
| Dracula | Dracula | dracula |
Dark | Vampire pink & cyber glow | Accent: #ff79c6 · BG: #191a21 · Text: #f8f8f2 |
| Cyberpunk | Cyberpunk | cyberpunk |
Dark | Neon green on black · matrix terminal | Accent: #00ff41 · BG: #000a00 · Text: #00ff41 |
| Solarized | Solarized Dark | solarized-dark |
Dark | Deep teal & cyan | Accent: #2aa198 · BG: #002b36 · Text: #93a1a1 |
| Solarized Light | solarized-light |
Light | Warm parchment & blue | Accent: #268bd2 · BG: #fdf6e3 · Text: #586e75 |
|
| Gruvbox | Gruvbox Dark | gruvbox-dark |
Dark | Retro dark & warm gold | Accent: #fabd2f · BG: #282828 · Text: #fbf1c7 |
| Gruvbox Light | gruvbox-light |
Light | Vintage kraft & warm amber | Accent: #b57614 · BG: #fbf1c7 · Text: #282828 |
|
| Catppuccin | Mocha | catppuccin-mocha |
Dark | Mocha dark & soothing | Accent: #cba6f7 · BG: #11111b · Text: #cdd6f4 |
| Macchiato | catppuccin-macchiato |
Dark | Macchiato soft tone | Accent: #c6a0f6 · BG: #181926 · Text: #cad3f5 |
|
| Frappé | catppuccin-frappe |
Dark | Frappé cool mist | Accent: #ca9ee6 · BG: #232634 · Text: #c6d0f5 |
|
| Latte | catppuccin-latte |
Light | Latte warm light | Accent: #8839ef · BG: #eff1f5 · Text: #4c4f69 |
5. Modular Sidebar Navigation (Expanded)
Reorderable navigation entries, in-place accordion drawer for tools (IM Assistant, Cron, Archive, Experts), and quick-action pinned rows.

6. Official Native 56px Rail (Collapsed)
Collapses seamlessly into the host official 56px compact activity rail. All plugin icons remain centered and accessible, with New Session prominently highlighted.

7. Enhanced Session Menu
Quick actions directly on session rows: Pin, Rename, Unread marker, Archive, Fork, and Safe Deletion.

Host Compatibility
- Supported Generations: Full DeepSeek Harness
0.2.xline (>=0.2.0-rc.1 <0.3.0-0); - Verified Builds: Supports every
0.2.xRC (0.2.0-rc.1,0.2.0-rc.2,0.2.1-rc.1–0.2.1-rc.5,0.2.2-rc.1–0.2.2-rc.3); intermediate alphas are not part of the support matrix; - Runtime Requirements: Node.js
^22.19.0 || >=24.0.0, pnpm^11.0.0.
⚠️ Notice: Do not enable Codex UI and
ds-botconcurrently. Both redesign sidebar and session slots with overlapping layout mechanics. Disable or uninstall one before enabling the other.
Installation & Getting Started
Option A: Agent-Assisted Installation (Recommended)
Copy and send this prompt to any agent capable of executing terminal commands (replace web with your target profile):
Please 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 to verify codex-ui is active and remind me to refresh my browser.
Option B: Manual Installation
Execute in PowerShell or MSYS Bash:
[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
Once installed, restart your DSH Web instance and hard-refresh your browser (Ctrl + Shift + R or Cmd + Shift + R).
Quick Reference
| Feature | How to Use |
|---|---|
| Accept Input Prediction | Press Tab when predictive ghost text appears behind the caret; press Alt + Down / Alt + Up to cycle recommendations, or Escape to dismiss. |
| Configure Prediction Mode | Go to Settings → Codex UI and select your prediction mode (Off, Continue Only, Guess & Continue) in the "Composer Enhancements" card. Can also be locked off wholesale across a profile by setting config.prediction: false in cordis.patch.yml. |
| Recall Input History | Press ↑ / ↓ in an empty composer to cycle through past inputs from the current conversation — or the whole workspace, switchable in Settings (up to 200 items per scope). |
| Change History Scope | In the same "Composer Enhancements" card, choose "History scope": "This conversation" (default) recalls only inputs from the current conversation; "Workspace" shares inputs with every conversation in the same working directory and makes previously stored workspace history visible again (retained up to the latest 100 scopes before eviction). |
| Resize Composer Width | Hover over either lateral border of the composer and drag the blue handles. |
| Switch Themes & Blur | Navigate to Settings → Codex UI, choose from 14 palettes, and toggle Stock/Mica or blur presets. |
| Reorder Sidebar Items | Drag any item vertically; blue indicators guide drop positions into or out of the More drawer. |
| Add Workspace from Section | Hover or focus any section header (Pinned, Projects, or custom) and click the Add workspace icon beside ··· (shown when host directory-picking is available); the new workspace is placed into that section and expanded automatically. |
| Collapse Sidebar | Click the collapse button on top of the sidebar to switch to the official 56px native icon rail. |
| Batch Upgrade Plugins | In Settings → Codex UI, click Update All on the Companion Plugins card. |
Ecosystem Matrix
Pair Codex UI with the first-party companion plugins for an integrated development workflow:
| Plugin | Purpose |
|---|---|
| Codex UI | UI Core: Rapid recall, settings skin, physical glass, and modular sidebar |
| Agency Agents | Specialist Matrix: Summon and dispatch specialized agent profiles |
| Skills Manager | Skills Hub: Discover, import, enable, and configure local agent skills |
| Archive Manager | Archive Vault: Deep search, restore, and prune historical sessions |
| IM Connect | Bridge: Connect WeChat, DingTalk, Feishu, and QQBot |
| Automation | Scheduler: Cron-based workflows and run evidence auditing |
| Code Review | Reviewer: /review dispatches subagents to audit code in-thread |
| Simplify | Refactor: /simplify concurrent 4-agent code cleanup |
| PUA | Resilience: Failure recovery, hypothesis switching, and evidence verification |
| BTW | Side-Questions: Ephemeral context inquiries without disrupting main tasks |
| Codex Pet | Companion: Desktop interactive pet for approvals and notifications |
License
Distributed and licensed under the Apache License 2.0.\n
Links
More in this category
zhu1090093659/dsh-web#packages/dsh-task-board★ 10461
Task board for the dsh web GUI: a sidebar multi-column kanban whose cards run in real DSH agent sessions and can also be scheduled with cron expressions, executed host-side even with the browser closed.
zhu1090093659/dsh-web#packages/dsh-web-all★ 10461
Plugin and skin collection for the DSH Web UI: task board, Git graph, right-side panel, remote mobile UI, pet, live token stats, and a skin center.
ccch1mneyyy/dsh-TUI★ 7811
Claude Code-style full-screen terminal UI: pixel-whale header, live status line, and streaming thought expansion.
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 7275
A fixed-corner whale widget for the DSH web GUI — balance, today's usage and per-turn cost with peak/off-peak pricing, editable balance-alert and daily-budget bubbles, a module-based custom bubble queue with A/B weighted choices and random lines or images, 30+ vendor templates (OpenAI, OpenRouter, Kimi, SiliconFlow, Ark, Zhipu, MiniMax and more) with per-model balance and subscription quota, plus task-end sound, imported audio, custom roles and a resource manager. Local-only, no telemetry.
omdsh-dev/DSH-better-sidebar★ 5195
Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.
omdsh-dev/dsh-genui★ 1008
Interactive UI components rendered inline in replies: layout, charts, forms, quizzes, mermaid, 3D scenes, and an action event loop back to the model.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.