explaingit

pingta-guangpingwang/claude-harness-desktop

Analysis updated 2026-05-18

★ 14TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A desktop app that lets one AI supervisor manage and monitor several Claude Code coding sessions running in parallel.

Mindmap

mindmap
  root((Claude Harness Desktop))
    What it does
      Multi project dashboard
      AI supervisor agent
      Task dispatch and monitoring
    Tech stack
      Electron and React
      TypeScript and Vite
      node-pty terminals
    Use cases
      Run parallel Claude sessions
      Broadcast commands
      Track stuck tasks
    Audience
      Developers
      Power users of Claude Code

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run and monitor several Claude Code projects from one dashboard instead of many terminal windows.

USE CASE 2

Broadcast the same instruction to every active project at once.

USE CASE 3

Automatically detect and recover projects whose AI session got stuck.

USE CASE 4

Track whether each project is online, busy, or idle at a glance.

What is it built with?

ElectronReactTypeScriptVitenode-ptyClaude Code CLIDeepSeek API

How does it compare?

pingta-guangpingwang/claude-harness-desktop0xbebis/hyperpayalfredxw/nova
Stars141414
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardmoderate
Complexity3/55/53/5
Audiencedeveloperdeveloperwriter

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires pnpm and a working Claude Code CLI plus a DeepSeek API key to use the AI supervisor.

MIT license: use, copy, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

In plain English

Claude Harness Desktop is a desktop application that lets you run and supervise multiple Claude Code instances at the same time across different projects, all from a single interface. If you work on several codebases at once and use Claude Code, an AI coding assistant, for each one, switching between terminal windows manually becomes tedious. This app acts as a central cockpit that manages all those sessions in one place. The built-in AI supervisor, which the README calls the Harness Agent, is itself powered by an AI using the Claude Code CLI and the DeepSeek API. You give it a high-level task, and it automatically figures out which projects to assign work to, dispatches instructions, monitors progress, handles terminal prompts that pop up mid-task, and collects results into a summary report. You can also broadcast a single instruction to all open projects at once. Each project runs in its own managed terminal powered by node-pty and ConPTY, the same technology that powers built-in terminals in code editors. The app tracks whether each session is online, busy, or stuck, and can poll for output or stop tasks safely, protecting a busy project from being interrupted by a new task. The tech stack is Electron 28, the framework that wraps web apps as desktop applications, with a React 19 and TypeScript 5.9 front end, built with Vite 8. Data is stored locally as JSON files through fs-extra. The interface supports both Chinese and English. You would use this if you manage several AI-assisted coding projects and want to coordinate them without juggling multiple terminal windows.

Copy-paste prompts

Prompt 1
Explain how to set up Claude Harness Desktop with pnpm and run it in dev mode on my machine.
Prompt 2
Show me how the task_project and broadcast tools differ and when I would use each one.
Prompt 3
Walk me through building a simple plugin for Claude Harness Desktop's plugin system.
Prompt 4
Help me understand the IPC bridge pattern this app uses between its main process and UI components.

Frequently asked questions

What is claude-harness-desktop?

A desktop app that lets one AI supervisor manage and monitor several Claude Code coding sessions running in parallel.

What language is claude-harness-desktop written in?

Mainly TypeScript. The stack also includes Electron, React, TypeScript.

What license does claude-harness-desktop use?

MIT license: use, copy, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is claude-harness-desktop to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is claude-harness-desktop for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos