pilot-harness

Name: pilot-harness
Author: op7418

Pending

Pilot Harness — a CodePilot-inspired desktop client and plugin suite for DeepSeek Harness on macOS, Windows, and Linux.

51stars

2forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/op7418/pilot-harness

Getting Started

Guides for using ai agents skills like pilot-harness.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

README.md

Frequently Asked Questions

What is pilot-harness?

pilot-harness is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by op7418. Pilot Harness — a CodePilot-inspired desktop client and plugin suite for DeepSeek Harness on macOS, Windows, and Linux. It has 51 GitHub stars.

Is pilot-harness safe to use?

pilot-harness's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.

How do I install pilot-harness?

Clone the repository with "git clone https://github.com/op7418/pilot-harness" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is pilot-harness written in?

pilot-harness is primarily written in TypeScript. It is open-source under op7418 on GitHub, so you can review or fork the full source.

Are there alternatives to pilot-harness?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh pilot-harness against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

240,740

github-mcp-server refine-canvas-strokes

English | 中文

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 the installer for your system from GitHub Releases:

Platform	Download	Install and handle the security prompt
macOS (Apple Silicon)	DMG installer ZIP app	Open the DMG and drag `pilot-harness.app` into Applications. If macOS cannot verify the developer, use System Settings → Privacy & Security → Open Anyway. If it reports that the app is damaged, open Terminal and run:sudo xattr -rd com.apple.quarantine "/Applications/pilot-harness.app"open "/Applications/pilot-harness.app"Enter your login password when prompted; Terminal will not display it. Apple's security instructions.
Windows (x64)	EXE installer	Run the EXE. If Microsoft Defender SmartScreen says Windows protected your PC, first confirm that the file came from this Release, then choose More info → Run anyway. Do not disable SmartScreen globally. A managed computer may hide this option; contact its administrator instead. Microsoft's SmartScreen explanation.
Linux (x64)	AppImage DEB RPM	DEB: sudo apt install ./Pilot-Harness-Linux-amd64.debRPM: sudo dnf install ./Pilot-Harness-Linux-x86_64.rpmAppImage: chmod +x Pilot-Harness-Linux-x86_64.AppImage, then ./Pilot-Harness-Linux-x86_64.AppImage. If the file manager blocks execution, enable Allow executing file as program in file properties. The preview packages are unsigned, so only accept a package-manager warning after confirming the official Release source.

All current preview installers are unsigned. Only override an operating-system warning for files downloaded from this repository's official GitHub Release; do not turn off platform security globally. Signing and notarization are planned for a future release.

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

Area	What Pilot Harness adds	Ownership
Desktop shell	Native window, local runtime lifecycle, directory dialog, recovery, installers, and platform icons	Electron app
Visual system	CodePilot-inspired design tokens and component contracts	@deepseek-ai/dsh-client-ui-codepilot-theme
Workspace Files	Right sidebar, file count, branch summary, row actions, and @path insertion	@deepseek-ai/dsh-ui-worktree
Reminder summary	Active reminder count and nearest scheduled time in Session hover details	@deepseek-ai/dsh-ui-schedule-summary
Session export	Per-Session ZIP export from the Trajectory toolbar and /export	@deepseek-ai/dsh-session-log-export
Providers and models	Configurable adapter, credential/settings UI, live catalog, and multimodal labels	Existing Harness plugins plus the Pilot Harness desktop profile

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

Build an installer or run the desktop checks with:

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

The native CI matrix builds, tests, exercises the Electron flow, and packages on macOS, Windows, and Linux. Release candidates still need installation, title-bar, signing, notarization, and update checks on target machi