code-yeongyu/oh-my-openagent

OmO: Just type "mass ulw" keyword with your prompt. Now you are the master of graph engineering.

oh‑my‑openagent (OmO) – AI 기반의 "팀 모드" 개발 보조 도구

무엇인가요 – TypeScript 기반의 플러그인(또는 스탠드얼론 베타)으로, LLM 에이전트의 팀을 조율된 개발 팀처럼 작동시킬 수 있습니다. 이 도구는 OpenCode 편집기의 플러그인으로, Codex CLI의 컴포넌트 세트로, 또는 네이티브 명령줄 도구(omo-ai@beta)로 작동합니다. 핵심은 단일 명령어(ultrawork / ulw)를 제공하여 코드 생성, 린트, 검색, LSP 통합, 그리고 " discipline"(목표 지향적) 실행에 특화된 11개의 에이전트를 사전 구성된 상태로 시작합니다.

주요 개념 및 기능

기능	에디션	기능 설명
팀 모드	Ultimate	최대 8개의 병렬 에이전트와 리더인 "아키텍트" 에이전트; tmux 스타일 패널로 시각화.
`ultrawork` / `ulw`	양쪽 모두	전체 에이전트 스택을 활성화하고, 선언된 목표가 달성될 때까지 실행하는 1단어 진입점.
디스цип린 에이전트	Ultimate	전문 에이전트(Librarian, Explorer 등)를 오케스트레이션하는 내장 워크플로우.
IntentGate	Ultimate (Light는 `ultrawork`만 표시)	`ultrawork`, `team`, `hyperplan`과 같은 명령어를 키워드 기반으로 트리거 감지.
해시 기반 편집 도구	Ultimate (옵션)	`LINE#ID` 태그로 식별된 라인 수준 편집을 허용하여 오래된 라인 오류를 제거.
LSP 통합	양쪽 모두	에이전트를 위한 진단, 탐색, 심볼 검색, 워크스페이스 이름 변경 제공.
AST‑Grep	양쪽 모두	`sg` 도구를 통해 약 25개 언어에서 언어 인식 코드 검색/재작성 지원.
내장된 MCPs (websearch, context7, grep_app, LSP)	Ultimate	인터넷, 문서, GitHub, 에디터 데이터용 즉시 사용 가능한 마이크로 서비스 연결.
목표 / `/goal`	Ultimate	지속적인 스레드 수준의 목표; 플래그가 해제될 때까지 에이전트가 작업을 계속.
Todo 엔포서	Ultimate	무기동 에이전트를 감지하고 작업으로 다시 유도.
주석 체커	양쪽 모두	주석에 AI 생성 아티팩트가 남지 않도록 보장.
테레메트리	양쪽 모두	익명의 일일 활성 사용자 페인팅 (설정 또는 환경 변수로 비활성화 가능).

에디션 및 설치 방법

에디션	호스트	설치 명령어	디스크에 설치되는 내용
Ultimate (OpenCode)	OpenCode 편집기	`bunx oh-my-openagent install` (TUI)	`opencode.json` 항목, `~/.omo/omo.jsonc` 설정, 프로바이더 인증 프롬프트, 11개 에이전트 정의.
Light (Codex CLI)	Codex 명령줄 도구	`npx lazycodex-ai install` (또는 `npx lazycodex-ai install --no-tui --codex-autonomous`)	`~/.codex/plugins/cache/sisyphuslabs/omo/`, `~/.codex/config.toml` 블록, `~/.local/bin` 내 바이너리.
Senpi (베타)	스탠드얼론	`npm i -g omo-ai@beta` 후 `omo` 실행	OMO 확장이 번들된 글로벌 `omo` 바이너리; 호스트 에디터 필요 없음.

@beta 태그는 필수입니다. 일반 npm i -g omo-ai 패키지는 의도적으로 차단되어 있습니다.

일반 워크플로우 (Ultimate 에디션)

설치 프로그램 실행 – bunx oh-my-openagent install. 마법사가 모델 구독 정보(Anthropic, Gemini, Kimi 등)를 묻고 에이전트-모델 매트릭스를 생성합니다.
목표 설정 – OpenCode 콘솔에서 /goal "refactor the authentication module" 입력.
실행 – ultrawork (또는 단축 별칭 ulw) 입력. 리더 아키텍트 에이전트가 목표를 하위 작업으로 분할하고 전문 에이전트를 생성하며 결과를 에디터로 스트리밍합니다.
모니터링 – 팀 모드를 활성화한 경우 tmux 스타일 패널에서 각 에이전트의 실시간 출력을 확인할 수 있습니다.
반복 – /goal을 다시 사용하거나 Todo 엔포서가 작업을 계속하도록 에이전트를 유지합니다.

사용 사례

풀스택 코드 생성 – 고수준 설명을 바탕으로 작동하는 코드베이스 생성 (예: "45k 라인의 Tauri 앱을 SaaS 웹 앱으로 전환")
자동 린트 및 수정 – 내장된 eslint 스타일 에이전트로 수천 개의 경고를 몇 분 안에 제거.
리포지토리 전체 검색 및 대체 – AST‑Grep 기술을 사용해 여러 언어에서 안전하게 패턴을 재작성.
문서 및 웹 검색 보강 – websearch 및 context7 MCP가 최신 문서를 가져와 코딩 에이전트에 제공.
팀 스타일 브레인스토밍 – 팀 모드로 여러 에이전트가 서로 비판(예: hyperplan에 적대적 비평가 포함)하여 솔루션 품질 향상.

문서 및 커뮤니티

문서 사이트 – https://omo.dev/docs
Discord – https://discord.gg/PUwSMR9XNk
Twitter/X – https://x.com/justsisyphus
로드맵 – https://github.com/code-yeongyu/oh-my-openagent/blob/dev/ROADMAP.md
라이선스 – SUL‑1.0 (자세한 내용은 LICENSE.md 참조).

빠른 시작 체크리스트

# Ultimate (OpenCode)
bunx oh-my-openagent install   # 인터랙티브 TUI 실행
# Light (Codex CLI)
npx lazycodex-ai install      # ~/.codex에 플러그인 설치
# 스탠드얼론 베타
npm i -g omo-ai@beta && omo   # `omo` 명령어 제공

# 설치 후 (모든 에디션)
ultrawork   # 또는 `ulw`
# 지속적 목표 설정 (OpenCode 전용)
/goal "add unit tests for the payment service"

결론

oh‑my‑openagent는 실제로 유지보수 중인 프로젝트로, LLM 기반 에이전트의 컬렉션을 플러그인/CLI 생태계에 통합합니다. 여러 모델 제공자에 대한 번거로운 설정을 추상화하고, 개발자가 단일 진입점(ultrawork)을 통해 조율된 AI "팀"이 코드를 작성, 리팩터링, 디버깅하도록 할 수 있게 합니다.