# yeachan-heo/oh-my-codex

**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/yeachan-heo-oh-my-codex).**

30,984 stars · 2,432 forks · TypeScript

## Links

- GitHub: https://github.com/Yeachan-Heo/oh-my-codex
- awesome-repositories: https://awesome-repositories.com/repository/yeachan-heo-oh-my-codex.md

## Description

oh-my-codex is an AI coding workflow orchestrator and a retrieval augmented generation documentation assistant. It manages complex programming tasks through a structured sequence of planning, execution, and verification phases, while providing tools for querying and translating technical documentation.

The project utilizes Git worktrees to isolate parallel coding sessions, ensuring that concurrent tasks remain independent. It integrates a vector-store knowledge base to index documents into embeddings, enabling semantic search and factual context retrieval across multiple languages.

The system covers a broad range of capabilities including AI-driven software development automation, multilingual technical translation, and technical knowledge management. It incorporates a markdown wiki for project-specific information and uses a sidecar process for bounded state verification via shell commands.

The platform includes performance benchmarking for language models, measuring metrics such as hit rate and citation quality.

## Tags

### Artificial Intelligence & ML

- [Technical Documentation Retrieval](https://awesome-repositories.com/f/artificial-intelligence-ml/technical-documentation-retrieval.md) — Provides an AI-powered system to index and query technical documentation for context-aware answers across multiple languages.
- [Multi-Agent Coordination Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/orchestration-engines/ai-agent/multi-agent-coordination-systems.md) — Employs a multi-agent coordination system to synchronize shared state across parallel worker agents.
- [Worktree Isolation](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agentic-workflows/worktree-isolation.md) — Utilizes Git worktrees to create isolated filesystem environments for concurrent AI coding sessions.
- [AI Workflow Orchestrators](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-workflow-orchestrators.md) — Manages complex programming tasks through a structured sequence of planning, execution, and verification phases.
- [Retrieval-Augmented Generation](https://awesome-repositories.com/f/artificial-intelligence-ml/conversational-interfaces/retrieval-augmented-generation.md) — Utilizes vector embeddings to retrieve relevant document sections for factual AI response generation.
- [Repository Context Injection](https://awesome-repositories.com/f/artificial-intelligence-ml/language-model-orchestration/retrieval-augmented-generation/context-aware-chat-interfaces/repository-context-injection.md) — Injects retrieved document fragments and repository metadata into model prompts for factual response generation.
- [Prompt Augmenters](https://awesome-repositories.com/f/artificial-intelligence-ml/retrieval-augmented-generation-pipelines/prompt-augmenters.md) — Injects retrieved document fragments into model prompts to ensure responses are grounded in external data.
- [AI Knowledge Management](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-knowledge-management.md) — Provides a natural language interface for querying and extracting information from technical knowledge bases.
- [Technical Terminology Preservation](https://awesome-repositories.com/f/artificial-intelligence-ml/artificial-intelligence-tooling/language-model-integrations/translation-services/document-translators/technical-terminology-preservation.md) — Translates complex software documentation between languages while preserving specialized technical terminology.
- [Cross-Language Technical Analysis](https://awesome-repositories.com/f/artificial-intelligence-ml/cross-language-technical-analysis.md) — Analyzes software manuals written in different languages to understand system functionality.
- [Knowledge Retrieval Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/knowledge-retrieval-systems.md) — Implements automated interfaces to find specific answers and details within complex documentation sets.
- [Workflow State Persistences](https://awesome-repositories.com/f/artificial-intelligence-ml/workflow-state-persistences.md) — Saves plans, logs, and memory to local directories to maintain workflow continuity across sessions. ([source](https://cdn.jsdelivr.net/gh/yeachan-heo/oh-my-codex@main/README.md))

### Development Tools & Productivity

- [AI-Driven Development Workflows](https://awesome-repositories.com/f/development-tools-productivity/build-tooling/build-orchestration-logic/build-orchestration-configuration/build-automation-systems/workflow-execution/ai-driven-development-workflows.md) — Guides the full AI coding lifecycle from intent clarification and planning to execution and verification. ([source](https://cdn.jsdelivr.net/gh/yeachan-heo/oh-my-codex@main/README.md))
- [Documentation Translation Tools](https://awesome-repositories.com/f/development-tools-productivity/developer-utilities-libraries/workflow-productivity-enhancers/developer-productivity-utilities/developer-productivity/documentation-translation-tools.md) — Provides automated LLM-driven translation of technical documentation while preserving specialized terminology.
- [Custom Parallel Task Execution](https://awesome-repositories.com/f/development-tools-productivity/parallel-execution/custom-parallel-task-execution.md) — Runs multiple independent coding sessions using Git worktrees to perform concurrent work without conflicts.
- [Parallel Task Orchestrators](https://awesome-repositories.com/f/development-tools-productivity/parallel-execution/custom-parallel-task-execution/parallel-task-orchestrators.md) — Orchestrates multiple worker agents to perform parallel work on large tasks with centralized state reporting. ([source](https://cdn.jsdelivr.net/gh/yeachan-heo/oh-my-codex@main/README.md))
- [Interactive Coding Environments](https://awesome-repositories.com/f/development-tools-productivity/ai-coding-assistants/interactive-coding-environments.md) — Offers a command-line interface for interactive coding sessions with a large language model. ([source](https://yeachan-heo.github.io/oh-my-codex-website/))
- [Sidecar Execution Processes](https://awesome-repositories.com/f/development-tools-productivity/command-execution/sidecar-execution-processes.md) — Uses a native sidecar process to execute shell commands for bounded state verification of the project.

### Content Management & Publishing

- [Vector](https://awesome-repositories.com/f/content-management-publishing/documentation-knowledge-management/knowledge-bases/vector.md) — Uses a vector store to index document embeddings for semantic search and factual context retrieval.
- [AI Documentation Assistants](https://awesome-repositories.com/f/content-management-publishing/documentation-knowledge-management/ai-documentation-assistants.md) — Ships an AI assistant that interprets and translates technical documentation to help developers understand project details.
- [Multilingual Technical Parsers](https://awesome-repositories.com/f/content-management-publishing/documentation-knowledge-management/technical-documentation/multilingual-technical-parsers.md) — Parses and explains complex technical manuals and documentation in the user's native language.

### Data & Databases

- [Vector Document Indexing](https://awesome-repositories.com/f/data-databases/database-management-systems/database-engines/vector-databases/vector-document-indexing.md) — Converts text documents into mathematical vectors for efficient semantic search and context retrieval.
- [Vector Indexing](https://awesome-repositories.com/f/data-databases/vector-indexing.md) — Implements vector indexing of text documents to enable semantic search and context retrieval.
- [Local Persistence Layers](https://awesome-repositories.com/f/data-databases/local-persistence-layers.md) — Provides local file-based persistence for saving workflow plans, logs, and session memory.

### Software Engineering & Architecture

- [Automated Development Workflows](https://awesome-repositories.com/f/software-engineering-architecture/automated-development-workflows.md) — Automates the full software development lifecycle from intent and planning to execution and verification.
- [Technical Manual Translations](https://awesome-repositories.com/f/software-engineering-architecture/localization/language-translations/technical-manual-translations.md) — Leverages LLMs to translate software manuals while preserving specialized technical terminology.
- [Worktree Isolations](https://awesome-repositories.com/f/software-engineering-architecture/parallel-subagent-orchestrators/worktree-isolations.md) — Manages named Git worktrees to ensure parallel AI coding sessions remain independent and safe. ([source](https://cdn.jsdelivr.net/gh/yeachan-heo/oh-my-codex@main/README.md))
- [Workflow Orchestrators](https://awesome-repositories.com/f/software-engineering-architecture/workflow-orchestrators.md) — Orchestrates tasks through a structured sequence of intent clarification, planning, execution, and verification phases.

### Part of an Awesome List

- [Multilingual Documentation Access](https://awesome-repositories.com/f/awesome-lists/learning/multilingual-documentation-access.md) — Provides access to technical documentation in various languages to remove English proficiency barriers. ([source](https://github.com/Yeachan-Heo/oh-my-codex/tree/main/docs/readme))

### Testing & Quality Assurance

- [Bounded State Verifications](https://awesome-repositories.com/f/testing-quality-assurance/bounded-state-verifications.md) — Provides bounded verification of project states by running inspection shell commands through a sidecar process. ([source](https://cdn.jsdelivr.net/gh/yeachan-heo/oh-my-codex@main/README.md))
