Oh My OpenAgent (commonly invoked as omo) is an open-source terminal coding agent harness and workflow framework maintained by code-yeongyu. Designed to structure and enhance agentic coding sessions in local developer environments, it provides standardized configurations and multi-agent coordination capabilities directly within the terminal. In day-to-day operation, Oh My OpenAgent acts as an orchestration layer for terminal-based AI workflows. It integrates with runtime environments powered by tools like Bun and Node, interoperating with external agents and tools including Claude Code, Codex CLI, and Cursor via shared workspace configurations and Model Context Protocol (MCP) server endpoints. What sets Oh My OpenAgent apart is its focus on developer environment standardization and agent coordination. Rather than functioning purely as an isolated standalone chat interface, it provides shared hooks, automated knowledge base synchronization, and cross-tool configuration schemas (such as .codegraph and devcontainer definitions) so multiple agents can collaborate on the same codebase. The project is fully open source under community maintenance on GitHub, allowing developers to self-host and customize agent configurations without commercial licensing restrictions or vendor lock-in.
Multi-Agent Environment Integration — Unifies configuration hooks across terminal coding agents, Claude Code, Cursor, and Codex CLI. - Model Context Protocol (MCP) Support — Connects to local MCP servers like codegraph for structured code indexing and graph queries. - Dev Container Compatibility — Ships standardized devcontainer setups pinned to modern JavaScript runtimes such as Bun for reproducible execution. - Automated Repository Synchronization — Uses git hook workflows (post-commit, post-merge, post-checkout) to keep agent knowledge bases and indexes updated. - Agent Task Orchestration (omo) — Provides execution tooling designed to handle intensive, multi-step coding and maintenance tasks.
Use cases
Use Case: Cross-Agent Workspace Setup A developer working across multiple AI coding assistants (such as Claude Code and Codex) uses Oh My OpenAgent to maintain shared context, hooks, and index configurations without duplicating agent configurations across the repository.
Use Case: Automated Context Graph Maintenance A team configures the codegraph MCP integration via project-local configuration files, enabling coding agents to automatically query and sync code relationship graphs after git merges and checkouts.
Use Case: Standardized Dev Container Agent Execution A maintainer runs automated coding agents inside a standardized Bun-based dev container environment to ensure dependency consistency across developer machines and continuous integration workflows.
Who it is for
Oh My OpenAgent is designed for developers and engineering teams who use terminal-based AI agents and require structured multi-agent workflows, MCP integrations, and reproducible dev environments. It is less suited for casual developers seeking a basic, zero-configuration GUI chat assistant.
Install guide
Installation Clone the repository and install dependencies using Bun or Node: bash git clone https://github.com/code-yeongyu/oh-my-openagent.git cd oh-my-openagent bun install(Note: Ensure you are using the supported Bun or Node runtime specified in the repository devcontainer configuration.)
First Run Configure your local agent environment and MCP integrations: bash # Initialize local configurations and hooks cp .codegraph/config.example.json .codegraph/config.json # if applicable # Verify your MCP configuration cat .mcp.json
Example Session Run tasks or invoke the agent harness in your workspace: bash # Run the agent workflow harness bun run omo
SWE-agent — SWE-agent is an open-source autonomous software engineering agent harness built and maintained by researchers from Princeton University and Stanford University.…
Grite — Grite is an open-source terminal coding agent harness developed by Neul Labs. Implemented in Rust, it provides a lightweight command-line…
Weaver — Weaver is an open-source agent harness and orchestration framework maintained by sean35mm on GitHub. Built on top of the Bun…
Hivelore — Hivelore is an open-source agent harness and contextual memory orchestrator created by Doucs91. It provides persistent project memory, decision tracking,…
Context Bridge — Context Bridge is an open-source CLI agent harness and context orchestration utility developed by serdardb. It is built to facilitate…
Agentic Engineering Framework — Agentic Engineering Framework is an open-source orchestration harness and governance layer developed by Dimitri Geelen. It is designed to constrain,…