harmony-harness

中文 | English

A terminal-first AI agent framework for HarmonyOS development — create apps, build HAPs, install and run them in one sentence, with a self-evolving loop (cross-session memory, skill promotion, benchmarked optimization, gain attribution).

An independent community distro built on DeepSeek Harness (MIT) and its "Everything is a Plugin" architecture — no fork: upstream upgrades flow straight through. Model-agnostic with 34 vendor routes preset (GLM Coding Plan recommended).

$ hm tui
✦ hm-tui
█   █  ▄▀▄  █▀▀▀▄ ▄▄▄▄▄ ▄▄▄▄▄ █   █ ▄▄▄▄▄      ← HARMONY HARNESS
      glm-5.3 · High effort
      Evolve in harmony!

Features


🏗️ Scaffolding	`harmony_project_create` generates a full Stage-model project (AppScope/entry/hvigor/oh-package/tests, 63 files) with DevEco debug signing auto-wired
🔨 HAP build	`harmony_build_hap` runs the DevEco command-line chain (ohpm + hvigorw)
📲 Install & run	`harmony_run`: signing check → `hdc install` → `aa start` → bounded hilog tail (verified end-to-end on emulator)
👁️ Vision-as-a-tool	`harmony_see_image`: text-only main models see images on demand via a free vision endpoint (glm-4v-flash) — no route switch
🧠 Self-evolving	cross-session memory injected per session; skill drafts → static review → human-approved promotion; benchmarks + git snapshots (strictly-improve-or-rollback); SIP-Bench-style attribution
📡 Cybernetics	sense → world model → decide → act → feedback as an observable event domain
🎭 Dual modes	`hm` (HarmonyOS-focused) / `hm-general` (any coding) agent presets
🛡️ Safety	deny-first device gate (install/uninstall/wipe/reboot refused); evolution confined to `.harmony/**` with review gates
🔌 Model routing	34 vendor templates (see below), managed block in settings, routes coexist

Quick start

git clone https://github.com/swsgbl/harmony-harness.git
cd harmony-harness
pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/install.ps1   # one-shot, idempotent
hm model set glm-coding    # pick a route (list: hm model list)
hm tui

Then just say: "Create a HarmonyOS project my-app, build it and run it on the emulator."

Prerequisites with official links (Node ≥22, pnpm, Git, dsh, DevEco Studio, GLM/DeepSeek/…) — see the environment table (Chinese) or docs/INSTALL.md.

Tools (22)

harmony-tools(6): cjpm build/test · hdc devices/see_image/shell(gated)/hilog tail harmony-scaffold(3): project_create · build_hap · run harmony-evolution(9): remember · recall · skill_propose/list/promote · evo_git · bench_run · evo_report · evo_status harmony-cybernetics(3): sense · world_model · feedback

Docs

Install & usage · Architecture · Self-evolution design · Roadmap · Changelog · Credits

Non-affiliation notice

harmony-harness is an independent community open-source project (MIT). It is not affiliated with, endorsed by, or cooperating with Huawei, the OpenAtom Foundation, DeepSeek, or Zhipu AI. "HarmonyOS", "OpenHarmony", "DevEco Studio" and related names and marks belong to their respective owners; used here descriptively under fair use ("harmony" in its ordinary sense). Built on the MIT-licensed deepseek-harness and Cordis; self-evolution design references public mechanism ideas from Penguin Harness and Darwin Gödel Machine (no code copied). See NOTICE and CREDITS.

Status: v0.2.1 — alpha; surface may change.

Harmony Harness

Project README