git404hub

what is claude-harness-desktop fr?

pingta-guangpingwang/claude-harness-desktop — explained in plain English

Analysis updated 2026-05-18

14TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

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

vibe map

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 make with this?

VIBE 1

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

VIBE 2

Broadcast the same instruction to every active project at once.

VIBE 3

Automatically detect and recover projects whose AI session got stuck.

VIBE 4

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

what's the stack?

ElectronReactTypeScriptVitenode-ptyClaude Code CLIDeepSeek API

how it stacks up fr

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 i run it?

Difficulty · moderate time til it works · 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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.