OpenHands local-stack-runtime

This skill should be used when the user asks to "change the dev stack", "add a runtime service", "change the launcher", "update Docker", "bump Agent Server", "change ingress routing", or changes scripts/dev-*.mjs, runtime-services metadata, config/defaults.json, Docker, automation startup, process shutdown, or local authentication.

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/local-stack-runtime" ~/.claude/skills/all-hands-ai-openhands-local-stack-runtime && rm -rf "$T"

manifest: .agents/skills/local-stack-runtime/SKILL.md

source content

Local Stack and Runtime Services

Maintain the shared configuration and launch plumbing across Vite/static development, Agent Server, automation, ingress, the published binary, and the all-in-one Docker image.

Workflow

Read
```
references/guide.md
```
before changing launchers, runtime service metadata, version pins, Docker composition, auth generation, or process management.
Treat
```
config/defaults.json
```
and the injected
```
<RUNTIME_SERVICES>
```
block as authoritative.
Preserve coordinated process-tree shutdown and fail fast on missing prerequisites.
Keep Agent Server and automation versions compatible and authentication keys correctly scoped.
Update documentation and version-drift tests when changing pins or launch commands.
Validate each affected launch mode rather than assuming Vite, static, npm, Docker, and Electron behave identically.

Reference

references/guide.md
— Runtime-services schema and prompt plumbing, launcher environment variables, ingress routes, version synchronization, security, Docker build architecture, README synchronization, and spec-tag conventions.