EtherDocs
Integrate/Ether Code desktop

Ether Code desktop ​

Ether Code is Ether's local coding harness — not a full IDE. It claims tasks from Ether OS, runs agent CLIs on your machine, opens PRs, and reports back through the Harness API.

Stack ​

ComponentLocation
Purple UIether-code/apps/desktop (Vite + Tauri)
Harness servernpm run worker -- harness-server on :8792
Execution engine@ether-code/harness-runtime
Platform APIGET /api/harness/tasks/claimable, claim, result

Quick start ​

bash
# ether-api
cd ether-core && ./run_api.sh

# harness server
cd ether-code
export ETHER_TOKEN=… ETHER_API_BASE_URL=http://127.0.0.1:8080
npm run worker -- harness-server

# UI
npm run desktop

Set ETHER_HARNESS_MODE=remote on ether-api so coding tasks wait for Ether Code.

Agent backends ​

ETHER_CODE_BACKEND=cursor|claude|codex|agy|custom — see ether-code/docs/DESKTOP.md.

Contract v1.1 ​

  • ExecutionResult.status: failed
  • task.harness.ready WebSocket
  • Lease validation on steps/result
  • Richer ExecutionBundle (schema_version 2)

Full reference: Harness API.