Description
hmharness is a self-evolving agent framework specifically designed for HarmonyOS development. It offers a zero-dependency kernel and first-class self-evolution capabilities, integrated within the MCP ecosystem. The framework allows developers to scaffold, build, install, and run HarmonyOS applications seamlessly in a single command. Each evolution step is gated and reversible, ensuring a controlled development process.
Read More
The framework includes seven packages in one repository, featuring a zero-dependency kernel, self-evolution, the HarmonyOS native domain, the ops keeper, the execution layer, and two frontends. The loop kernel, context compression, approval gates, and session audit are all first-party components, while MCP connects the wider ecosystem.
hmharness provides parameterized scaffolding through the harmony_project_create command, enabling the generation of multi-page and feature HAP and HAR libraries in one call. This is verified against real hvigor builds. The framework supports a full emulator lifecycle without the need for an IDE, allowing developers to manage device models and variants directly through a headless CLI.
The self-evolution process is double-gated, involving insight mining, skill proposals, training gate A/B bench, and promotion to a canary stage. Impact verdicts are based on session performance, with harmful evolutions being retired and instant rollback available on regression. The MCP client is hand-written with zero dependencies, supporting over 5,800 community servers for plug-and-play functionality.
hmharness includes an ops keeper with an 8-source OpenHarmony radar that monitors scaffold and gate assumptions daily. It features two frontends: a fullscreen TUI and a web UI, with built-in safety measures such as deny-first approval gates and append-only session audits. The tool supports bilingual zh/en UI and system prompts, and is compatible with any OpenAI provider, ensuring model-agnostic context engineering.
- CategoryAI Agent Builders
- Pricing ModelOpen source
- DeploymentCLI
- PlatformsHarmonyOS
hmharness's Core Features
Zero-dependency kernel
First-class self-evolution
MCP ecosystem integration
Parameterized scaffolding
Full emulator lifecycle without IDE
Double-gated self-evolution process
Ops keeper with OpenHarmony radar
Bilingual zh/en UI support
Getting Started with hmharness
Install: Set up Node >= 22 and HarmonyOS toolchain
Scaffold: Use harmony_project_create for project setup
Build: Execute builds with hvigor
Run: Install and launch apps with hdc
hmharness's Use Cases
- HarmonyOS App Development
- Self-Evolving Framework
- MCP Ecosystem Integration
- Headless CLI Operations
- Bilingual Development





