One-Line Description

Give the DeepSeek Harness client a CodePilot visual style (light/dark color schemes, rounded corners, embedded brand icons) without changing interaction logic or affecting models. On desktop, the native title bar appearance will also switch to the same theme mode.

Core Features

• Inject CodePilot light and dark color schemes, covering Pilot color/platform surface tokens and Harness semantic, component, and shadow alias tokens
• Set data-codepilot-theme="true" activation marker on the html root element; restore the previous state of this attribute when the plugin is uninstalled
• Embed brand icons (packaged as data URLs in the bundle), replacing the empty session page hero area, sidebar expanded/collapsed states, and brand position on the About page
• On desktop, synchronize the current theme mode (system/light/dark) to the native window via Electron preload bridge, updating window materials, backdrop, and Windows title bar buttons
• Subscribe to theme/change events to follow in-app theme switching, keeping native appearance consistent with the client on desktop
• Fully reversible loading and unloading: remove activation markers, release effect subscriptions, rely on CSS module scope automatic invalidation, and return to the default theme

Technical Implementation

• Language: TypeScript (ESM, two tsconfig outputs: host and client)
• Key Dependencies: @deepseek-ai/cordis, @deepseek-ai/dsh-client-runtime, @deepseek-ai/dsh-client-ui-theme, @deepseek-ai/dsh-invariants (all peerDependencies, resolved as workspace)
• Architecture Pattern: DSH Client Cordis plugin, package.json#dsh.client declares platform: "web", inject only for pre-check display; inject styles via CSS Modules + root element data-codepilot-theme attribute scope; ctx.effect() hook handles activation marker set/restore and desktop theme event subscription lifecycle
• Entry Files: src/client/index.ts (activation and synchronization logic), src/index.ts (host marker placeholder), src/invariant.ts (declares package name, with "no runtime invariant" reason), src/client/theme.module.css and src/client/brand-icon.module.css (styles)

Use Cases

Ordinary users who want to change their DSH client to CodePilot/Luma visual style. Installed once and takes effect immediately, no configuration options, no side effects; if you only want to take a quick look, you can also install and uninstall anytime.

Prerequisites and Compatibility

Installation

dsh plugin --profile web add github:op7418/pilot-harness/packages/client/ui-codepilot-theme

Configuration

This plugin requires no additional configuration. package.json does not declare a Config schema, and the source code does not read any configuration or environment variables; styles, activation markers, and synchronization logic are all hardcoded.

FAQ

Q: How to confirm it takes effect after installation?

A: After restarting the web profile, run dsh --profile web --dump-config. If you see the codepilot-theme node, it loaded successfully. You can also directly open the client to see if the sidebar and empty session page have switched to CodePilot visual style.

Q: How to uninstall and return to the original theme?

A: Run dsh plugin --profile web remove @deepseek-ai/dsh-client-ui-codepilot-theme and restart the profile. The data-codepilot-theme marker will be cleared during uninstall, and any previous value will be restored.

Q: Will installing it change model responses, conversation content, or tool behavior?

A: No. Both the source code and README declare that it does not register any model-facing context, tools, events, or request content. It's purely a client-side presentation layer replacement.

Q: Can it be used on both desktop and browser?

A: Yes, both work. Browser side applies the same CSS; desktop side goes one step further: synchronizes the current theme (system/light/dark) to the native window via Electron preload bridge, letting the title bar, materials, and window backdrop follow the switch.

Q: Will installing this theme invalidate my previous KV cache?

A: No. The README clearly states that both Model Experience and KV Cache impact are "none". Loading or uninstalling only affects client display, not model input.

Q: Will it conflict with other style/theme plugins I've already installed?

A: Both light and dark sides cover the same set of Pilot and Harness semantic tokens. Plugins loaded later won't leave misaligned values like light text or sidebar materials; uninstallation cleanly restores without mutual pollution.

Q: If the product icon file changes, will the theme automatically update?

A: No. Each time apps/desktop/assets/icon-master.png is modified, you need to manually run pnpm --filter @deepseek-ai/dsh-desktop run icons in the repository root to regenerate the brand stylesheet in the bundle, then repackage and publish.

Getting Started

Beginner — one dsh plugin add command + restart the profile is all it takes. No configuration options, won't change model context. Ordinary users can install and try directly, uninstall if they don't like it.

Known Issues and Limitations

• After modifying apps/desktop/assets/icon-master.png, you must run pnpm --filter @deepseek-ai/dsh-desktop run icons to refresh the brand stylesheet embedded in the bundle. Otherwise, the client will still display the old icon.
• New brand positions need to first have a data-pilot-brand-mark presentation layer hook added to the host and complete a visual audit before the theme can replace them in a reversible way; when upstream adds brand positions without hooks, this plugin won't automatically take them over.

Pilot Harness

English | 中文

A CodePilot-inspired desktop client and plugin suite for DeepSeek Harness.

Run the DeepSeek Harness plugin runtime as a focused native app, manage providers and multimodal models visually, and keep desktop additions isolated as ordinary Harness plugins.

Quick start · Plugins · Architecture · MIT License

Why Pilot Harness

DeepSeek Harness has a powerful “everything is a plugin” architecture, but its default experience is designed around a CLI-launched Web UI. Pilot Harness keeps that runtime model and adds the parts expected from a daily desktop product:

• A real desktop app — Electron packages the local Harness runtime for macOS, Windows, and Linux, owns native window behavior, and provides a recovery screen when startup needs attention.
• A calmer CodePilot-inspired interface — consistent tokens, radii, menus, hover states, settings cards, Markdown, conversation/trajectory navigation, and platform-aware title bars.
• Provider and model management — connect supported providers, declare an OpenAI-compatible endpoint, manage credentials separately from settings, browse the live model catalog, and identify image-capable models.
• Workspace context without clutter — project-aware conversation rows show branch, state, reminder summary, mode, and model details, while Files opens as a true right sidebar.
• Plugin-first extensions — the theme, Worktree sidebar, Schedule summary, and Session-log export remain Cordis/DeepSeek Harness rows rather than desktop-only business logic.
• Reversible customization — disabling the CodePilot theme row removes its product mark and visual overrides so the stock Harness presentation can take over again.

Pilot Harness does not replace the DeepSeek Harness agent loop, Session log, tool pipeline, provider contracts, or RPC implementation. Electron owns packaging and native integration; the composed Harness plugin tree remains the application runtime.

Quick Start

Download Pilot Harness

Download the installer for your system from GitHub Releases:

The table links to formal end-user Releases, not the seven-day Actions preview artifacts. Formal macOS files must pass Developer ID verification before publication; while they remain unnotarized, the only expected extra step is Open Anyway in System Settings. Preview macOS artifacts are ad-hoc signed for CI verification and are not the normal installation path. Once notarization is enabled, the Open Anyway step should normally disappear and this guide must be updated with the release pipeline. Windows and Linux preview installers remain unsigned. Only override an operating-system warning for files downloaded from this repository's official GitHub Release; do not turn off platform security globally.

After installation, open Pilot Harness, select a Workspace, then go to Settings → Providers to connect a provider and choose one of its available models. No separate DeepSeek Harness installation is required for the desktop app. Source setup and packaging instructions live in Development, not in the user installation path.

What is included

The provider/model experience is deliberately a profile composition, not a new provider implementation. It mounts existing adapter, Settings, and Credentials contracts, then replaces the desktop placeholder only after a real provider advertises a usable model.

Use the plugins independently

The desktop client already includes every plugin below. If you use a local DeepSeek Harness Web profile instead, install only the feature you want with one command; each release asset is a prebuilt dsh.bundle, so no repository clone, YAML patch, or local build is required.

CodePilot theme

dsh plugin --profile web add https://github.com/op7418/pilot-harness/releases/latest/download/deepseek-ai-dsh-client-ui-codepilot-theme-0.1.0-rc.5.tgz

Applies the Pilot Harness visual system and product mark. Removing the plugin restores the stock Harness presentation. See theme details.

Files sidebar

dsh plugin --profile web add https://github.com/op7418/pilot-harness/releases/latest/download/deepseek-ai-dsh-ui-worktree-0.1.0-rc.5.tgz

Adds the Workspace-confined right file sidebar, file count, branch summary, row actions, and @path insertion. See Files plugin details.

Reminder summary

dsh plugin --profile web add https://github.com/op7418/pilot-harness/releases/latest/download/deepseek-ai-dsh-ui-schedule-summary-0.1.0-rc.5.tgz

Adds active-reminder metadata to Session hover details while the upstream Schedule plugin remains the reminder authority. See reminder plugin details.

Session-log export

dsh plugin --profile web add https://github.com/op7418/pilot-harness/releases/latest/download/deepseek-ai-dsh-session-log-export-0.1.0-rc.7.tgz

Adds per-Session ZIP export to the Trajectory toolbar and the /export command. See export plugin details.

Restart the Web profile after installation and use dsh --profile web --dump-config to confirm the added row. Files and Reminder summary require the Pilot Harness UI slot contracts included in Pilot Harness v0.1.0; older upstream Harness builds can install their bundles but cannot render those two UI contributions.

Remove a plugin with the same package name shown in its details page, for example:

dsh plugin --profile web remove @deepseek-ai/dsh-ui-worktree

Development

git clone https://github.com/op7418/pilot-harness.git
cd pilot-harness
pnpm install
pnpm run desktop:dev

Run the desktop checks with:

pnpm run desktop:test
pnpm --filter @deepseek-ai/dsh-desktop run typecheck
pnpm --filter @deepseek-ai/dsh-desktop run test:e2e

Official installers are never built or uploaded from a developer machine. Every verified push to main, and a manual workflow dispatch without a release tag, produces seven-day Actions preview artifacts on native macOS, Windows, and Linux runners. A version-matched v* tag starts the formal path, verifies the platform artifacts and macOS Developer ID signature, generates SHA256SUMS.txt, and publishes the GitHub Release.

The Sync DeepSeek Harness upstream workflow checks the newest non-draft official release every day at 09:00 Asia/Shanghai. A clean update is merged without force-pushing, verified, committed to main, and dispatched to the same native release pipeline as v<upstream-version>-pilot.1. A merge conflict opens or refreshes a GitHub Issue and stops before changing main; missing macOS signing secrets also open an issue and leave the verified source synchronized without publishing an unsigned release. Rerunning the workflow after resolving either condition resumes the pending release.

For the underlying system, read the DeepSeek Harness architecture, development guide, and desktop architecture.

Upstream, attribution, and trademark notice

Pilot Harness is an independent community project derived from the MIT-licensed DeepSeek Harness and visually inspired by CodePilot. It is not an official DeepSeek product and is not endorsed by or affiliated with DeepSeek. “DeepSeek”, “DeepSeek Harness”, and “CodePilot” remain the property of their respective owners.

License

Pilot Harness is available under the MIT License. Third-party software and licenses are listed in THIRD_PARTY_NOTICES.md.