DeepSeek Harness for macOS

A lightweight native macOS wrapper for the official DeepSeek Harness Web UI.

It turns the local Harness server into a normal Mac app: double-click to launch, use it in a dedicated window, and let the app start or reconnect to dsh automatically.

Community project. This repository is not affiliated with, endorsed by, or maintained by DeepSeek.

中文说明

Features

• Native SwiftUI window with an embedded Harness Web UI
• Connects to an existing Harness server at 127.0.0.1:3080
• Starts the locally installed dsh server when one is not already running
• Stops only the server process started by the app itself
• Keeps Harness workspaces, sessions, model providers, and credentials in their original storage
• Opens external links in the default browser
• Supports the model providers available in the installed Harness version, including custom providers

Requirements

• macOS 14 or later
• Apple Silicon Mac
• Xcode Command Line Tools or Xcode with Swift 5.10 or later
• Node.js 22.19 or later
• DeepSeek Harness installed globally:

npm install -g @deepseek-ai/dsh

Build and run

git clone https://github.com/Starmadebydata/deepseek-harness-macos.git
cd deepseek-harness-macos
./script/build_and_run.sh

The app bundle is generated at:

dist/DeepSeek Harness.app

Build without launching:

./script/build_and_run.sh --build

Run tests:

swift test

Model providers

Provider configuration remains inside DeepSeek Harness. Open Settings → Models to configure an official provider or add a custom endpoint. API keys are handled by Harness and are not written into this repository.

How it works

On launch, the app checks http://127.0.0.1:3080:

1. If Harness is already running, the app connects without taking ownership of that process.
2. Otherwise, it finds the installed dsh executable and starts dsh web locally.
3. On quit, it terminates the server only when that server was started by the app.

Distribution note

Local builds use ad-hoc signing. They are intended for development and personal use. Public binary releases require an Apple Developer ID certificate and notarization.

Contributing

See CONTRIBUTING.md.

Security

See SECURITY.md for reporting security issues.

License

This wrapper is released under the MIT License. DeepSeek Harness is a separate project with its own license and trademarks.