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

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