How to use pilot-harness
A presentation-layer theme package that applies a CodePilot visual skin to the DSH Web/Desktop client without modifying interaction logic or model context.
This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.
This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.
Quick start
pilot-harness (ui-codepilot-theme)
— source: plugin_wiki.wiki_content
Install & verify
dsh plugin --profile web add github:op7418/pilot-harness#path:packages/client/ui-codepilot-theme
Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.
— source: plugins.install
Key points
- 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.
- 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.
— source: plugin_wiki.readme_en (fallback readme_raw)
FAQ
How to confirm it takes effect after installation?
After restarting the Web profile, run dsh --profile web --dump-config; if you can see the codepilot-theme node, it means the loading was successful; you can also directly open the client to see if the sidebar/empty session page has switched to CodePilot visuals.
How to uninstall and return to the original theme?
Run dsh plugin --profile web remove @deepseek-ai/dsh-client-ui-codepilot-theme, then restart the profile. The plugin will automatically clean up the data-codepilot-theme marker and restore your previous state during uninstallation.
Will installing it change the model's responses, conversation content, or tool behavior?
No. Both the source code and README clearly state that it doesn't register any model-facing context, tools, events, or request content - it's purely a client-side presentation layer replacement.
Can it be used on both desktop and browser?
Yes, both work. The browser side applies the same CSS; the desktop side goes one step further: it syncs the current theme (system/light/dark) to the native window via Electron preload, so the title bar, materials, and window backdrop follow the theme switch.
Will installing this theme invalidate my previous KV cache?
No. The README states that both Model Experience and KV Cache impact are "none". Loading or uninstalling only affects the client display and doesn't modify model input.
Will it conflict with other style/theme plugins I've already installed?
No. Both light and dark modes 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.
If the product icon file changes, will the theme update itself?
No automatic updates. 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.
— source: plugin_wiki.faq_json
Compatibility
- DSH: 0.1.0-rc.7+
- Node: >=22.19.0
— source: plugin_wiki.compatibility_json
Pitfalls
Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.
— source: general rule