OpenHands desktop-electron

This skill should be used when the user asks to "change the desktop app", "package Electron", "build a universal macOS app", "bundle Node or uv", "fix Electron startup", or changes electron/, electron-builder.config.mjs, desktop workflows, bundled runtimes, or desktop process startup.

install

source · Clone the upstream repo

git clone https://github.com/OpenHands/OpenHands

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/OpenHands/OpenHands "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.agents/skills/desktop-electron" ~/.claude/skills/all-hands-ai-openhands-desktop-electron && rm -rf "$T"

manifest: .agents/skills/desktop-electron/SKILL.md

source content

Electron Desktop

Preserve desktop startup reliability and packaging invariants across development, installed single-architecture builds, and universal macOS builds.

Workflow

Read
```
references/guide.md
```
before changing Electron startup, branding, packaging hooks, runtime resources, or desktop CI.
Test cold-start readiness independently from ingress readiness.
Keep packaged dependency stripping and the explicit runtime package closure synchronized.
Validate bundled Node and uv paths on every affected platform and architecture.
Test installed artifacts outside the repository tree so local
```
node_modules
```
cannot hide missing packaged dependencies.

Reference

references/guide.md
— Cold-start coordination, loading feedback, node_modules stripping, universal runtime layout, macOS development branding, and bundled Node/npm/npx behavior.