# Oh-My-OpenAgent — Multi-Harness Coding Agent Orchestrator

> An open-source agent harness that wraps Codex, OpenCode, and other coding CLIs with hooks, agent teams, HUDs, and workflow extensions.

## Install

Save as a script file and run:

# Oh-My-OpenAgent — Multi-Harness Coding Agent Orchestrator

## Quick Use
```bash
npx oh-my-openagent init
# or clone and install
git clone https://github.com/code-yeongyu/oh-my-openagent.git
cd oh-my-openagent && npm install
```

## Introduction
Oh-My-OpenAgent (OMO) is an open-source orchestration layer for AI coding agents. It wraps existing coding CLIs like Codex and OpenCode, adding hooks, multi-agent teams, and a heads-up display to make agentic coding sessions more controllable and observable.

## What Oh-My-OpenAgent Does
- Wraps multiple coding agent CLIs under a single orchestration layer
- Provides a HUD (heads-up display) for monitoring agent progress
- Enables multi-agent team workflows where agents collaborate on tasks
- Adds hook systems for pre/post agent actions and custom automation
- Supports session management with persistent context across runs

## Architecture Overview
OMO sits as a thin wrapper around existing coding agent binaries. It intercepts their I/O streams, applies configured hooks, and routes tasks to the appropriate agent. The HUD renders real-time status in the terminal using a TUI framework. Agent teams are coordinated through a simple YAML-based configuration that defines roles and task routing rules.

## Self-Hosting & Configuration
- Install via npm or clone the repository directly
- Configure agent backends in a YAML config file
- Set up hook scripts for custom pre/post actions
- Define agent teams with role assignments and routing rules
- Environment variables control default model and provider settings

## Key Features
- Harness-agnostic: works with Codex, OpenCode, and other CLI agents
- Real-time TUI dashboard for monitoring agent activity
- Hook system for automation and custom workflows
- Multi-agent team coordination with role-based routing
- Extensible plugin architecture for community contributions

## Comparison with Similar Tools
- **Claude Code** — native Anthropic agent; OMO wraps it rather than replacing it
- **Archon** — focuses on harness building; OMO focuses on orchestrating existing agents
- **AionUI** — web-based UI for agents; OMO is terminal-native
- **Roo Code** — VS Code extension; OMO is CLI-first and editor-agnostic

## FAQ
**Q: Does OMO replace my existing coding agent?**
A: No. It wraps and enhances existing agents by adding orchestration, hooks, and monitoring on top.

**Q: Which coding agents are supported?**
A: Codex CLI, OpenCode, and other terminal-based coding agents. The plugin system allows adding more backends.

**Q: Is an API key required?**
A: OMO itself needs no key. The underlying agents you configure may require their own API keys.

**Q: Can I run multiple agents simultaneously?**
A: Yes. The team feature lets you define agent roles that work in parallel on different parts of a task.

## Sources
- https://github.com/code-yeongyu/oh-my-openagent


---
Source: https://tokrepo.com/en/workflows/asset-72d63d08
Author: Script Depot