# hkuds/openharness

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/hkuds-openharness).**

14,084 stars · 2,321 forks · Python · MIT

## Links

- GitHub: https://github.com/HKUDS/OpenHarness
- awesome-repositories: https://awesome-repositories.com/repository/hkuds-openharness.md

## Description

OpenHarness is a framework for building and orchestrating AI agents that utilize tools and plugins to execute complex tasks. It provides an orchestration system for managing language model lifecycles and a multi-agent coordination system for delegating workloads across teams of specialized subagents.

The project features an agent gateway that bridges language model agents to external chat platforms and communication channels. It includes a tool integration engine for executing shell, file, and web operations, supported by a memory and skill manager that handles persistent user preferences and the on-demand injection of domain-specific knowledge.

The framework incorporates security via path-based access controls and interactive approval workflows for sensitive operations. It also provides a dry-run mode for execution plan inspection, a plugin architecture for custom lifecycle hooks, and a terminal user interface for session management and real-time feedback.

## Tags

### Artificial Intelligence & ML

- [Agentic LLM Frameworks](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-llm-frameworks.md) — Provides a platform for building and managing autonomous agents powered by LLMs with tool use and memory support.
- [AI Agent Orchestration Frameworks](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-agent-orchestration-frameworks.md) — Provides a framework for managing autonomous agent loops and tool discovery to execute complex tasks.
- [Multi-Agent Coordination Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/orchestration-engines/ai-agent/multi-agent-coordination-systems.md) — Implements a delegation system allowing specialized agents to collaborate on complex tasks by sharing state. ([source](https://cdn.jsdelivr.net/gh/hkuds/openharness@main/README.md))
- [Recursive Subagent Nesting](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-orchestration-multi-agent/subagent-design/subagent-architectures/recursive-subagent-nesting.md) — Manages complex workflows via recursive delegation to specialized subagents in independent lifecycles.
- [Communication Gateways](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/development-runtime-environments/ai-agent-infrastructure/communication-gateways.md) — Ships a gateway that routes messages between external communication platforms and AI agents.
- [Agent Orchestrators](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/agent-orchestrators.md) — Provides a system to manage the reasoning loops and execution lifecycles of language model-based agents. ([source](https://cdn.jsdelivr.net/gh/hkuds/openharness@main/README.md))
- [Agent Memory Managers](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/memory-context-systems/agent-memory-architectures/agent-memory-managers.md) — Provides a system for managing persistent user preferences and the storage and retrieval of agent memory.
- [LLM Tooling Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/artificial-intelligence-tooling/language-model-integrations/llm-tooling-integrations.md) — Connects language models to shell, web, and file system tools with type-safe validation.
- [Custom AI Assistant Development](https://awesome-repositories.com/f/artificial-intelligence-ml/custom-ai-assistant-development.md) — Enables building personalized AI assistants with custom plugins, on-demand skills, and persistent memory.
- [Multi-Agent Orchestration Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/multi-agent-orchestration-systems.md) — Orchestrates teams of specialized autonomous agents to execute complex, collaborative workflows.
- [Agent Gateways](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-gateways.md) — Provides a gateway that bridges AI agents to external chat platforms and communication channels. ([source](https://cdn.jsdelivr.net/gh/hkuds/openharness@main/README.md))
- [Dynamic Skill Injection](https://awesome-repositories.com/f/artificial-intelligence-ml/dynamic-skill-injection.md) — Implements on-demand injection of domain-specific markdown knowledge into the agent's context.
- [LLM Provider Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/llm-provider-integrations.md) — Offers a configurable profile system for managing connectivity and authentication to various AI provider backends. ([source](https://cdn.jsdelivr.net/gh/hkuds/openharness@main/README.md))
- [Type-Safe Execution Frameworks](https://awesome-repositories.com/f/artificial-intelligence-ml/workflow-as-a-tool-exposure/agent-as-a-tool-execution/type-safe-execution-frameworks.md) — Ships a type-safe validation system for executing shell, file, and web tools. ([source](https://cdn.jsdelivr.net/gh/hkuds/openharness@main/README.md))

### Security & Cryptography

- [Tool Execution Permissions](https://awesome-repositories.com/f/security-cryptography/permission-based-access-control/tool-execution-permissions.md) — Enforces security through path-level access rules and interactive approvals for sensitive tool executions. ([source](https://cdn.jsdelivr.net/gh/hkuds/openharness@main/README.md))
- [Path Access Restrictions](https://awesome-repositories.com/f/security-cryptography/security/policies/host-resource-access/file-system-access-controls/path-access-restrictions.md) — Restricts agent file system operations using path-based security rules and interactive user approvals.

### Data & Databases

- [Agentic Memory Systems](https://awesome-repositories.com/f/data-databases/agentic-memory-systems.md) — Ships a storage system for maintaining long-term user preferences and interaction continuity. ([source](https://cdn.jsdelivr.net/gh/hkuds/openharness@main/README.md))

### Development Tools & Productivity

- [Tool Execution Inspection](https://awesome-repositories.com/f/development-tools-productivity/ai-assistant-integrations/tool-integrated-assistants/tool-execution-inspection.md) — Includes a dry-run mode for inspecting the intended tool calls and actions before they are executed. ([source](https://cdn.jsdelivr.net/gh/hkuds/openharness@main/README.md))
- [Agent Session Persistence](https://awesome-repositories.com/f/development-tools-productivity/database-session-management/session-state-persistence/agent-session-persistence.md) — Maintains continuity across interactions by storing user preferences and knowledge in dedicated local files.

### Software Engineering & Architecture

- [Data Type Validation](https://awesome-repositories.com/f/software-engineering-architecture/data-schema-validation/data-type-validation.md) — Ensures language model outputs match expected schemas through strict type validation before tool execution.
- [AI Backend Abstractions](https://awesome-repositories.com/f/software-engineering-architecture/execution-backend-abstractions/ai-backend-abstractions.md) — Decouples core logic from specific models through a provider-based abstraction for remote and local backends.
- [Extensible Plugin Architectures](https://awesome-repositories.com/f/software-engineering-architecture/extensible-plugin-architectures.md) — Provides a modular extension system allowing custom commands and lifecycle hooks to modify agent behavior. ([source](https://cdn.jsdelivr.net/gh/hkuds/openharness@main/README.md))
- [Skill Files](https://awesome-repositories.com/f/software-engineering-architecture/project-context-managers/on-demand-context-loading/skill-files.md) — Implements modular, domain-specific instruction files loaded into the agent context to guide task execution. ([source](https://cdn.jsdelivr.net/gh/hkuds/openharness@main/README.md))