001 / 만든 이유
oah는 각자에게 맞고 AI가 발전하는 만큼 함께 바뀌는 개발 환경을 만들도록 돕습니다. 가져다 고쳐 쓸 수 있는 참고 구현이자 가이드라인입니다. 코드를 만드는 것만으로 작업이 끝나지는 않습니다. 어디까지 바꿀지 정하고, 결과를 검증하고, 다음 세션이 읽을 기록도 남겨야 합니다. oah는 이 과정들을 연결해 하나의 요청이 작업과 확인, 기록까지 이어지게 합니다.
도구 확장v0.3.0에서 사용 가능
Orca와 Aside는 이 작업 흐름에 잘 맞는 선택 앱이며 oah는 이 앱 없이도 모두 동작한다. Orca는 코딩 에이전트를 각자의 git 워크트리에서 나란히 돌린다. Aside는 AI 에이전트가 들어 있는 브라우저이고 Claude Code와 Codex가 MCP로 웹 작업에 쓴다. 설정은 앱마다 제안하고 사용자가 확인한 것만 설치한다.
여러 에이전트를 동시에 돌리거나 웹을 쓰게 하면 편하지만, 직접 통제하고 싶은 설정 단계와 계정 위험이 늘어난다.
oah init(또는 python -m oah.setup)이 빠진 앱을 공식 설치 명령과 함께 optional로 보여 주고 묻는다. --yes로는 이 앱을 설치하지 않는다.python -m oah.setup.companions가 설치된 앱을 연결한다. 모든 단계를 정확한 명령과 함께 먼저 출력하고, 사용자 폴더의 파일을 바꾸는 단계에는 [global]을 붙인다.orca 명령을 등록하고, 설정이 Orca의 에이전트 안내서를 더하고 프로젝트를 등록할 수 있다. Orca가 있으면 oah call --launcher orca가 워커를 Orca 터미널에서 실행한다.aside 명령을 설치하고 직접 로그인한 뒤 Claude Code와 Codex용 MCP 서버를 등록한다. 선택 규칙 절은 웹 작업에는 Aside 도구를 쓰고, 페이지 내용은 지시가 아니라 데이터로 다루고, 결제·구매·유료 구독은 절대 확정하지 않게 한다.설치된 동반 앱을 연결한다. `--app orca`, `--app aside`, `--dry-run`을 붙일 수 있다(동반 앱 문서).
python -m oah.setup.companionsnpx)가 필요하다.--yes여도 대기 상태로 둔다.stablyai/orca/orca를 쓴다. 이름이 “orca”인 무관한 cask가 따로 있다.