← 전체 기능

도구 확장v0.3.0에서 사용 가능

동반 앱 Orca와 Aside

Orca와 Aside는 이 작업 흐름에 잘 맞는 선택 앱이며 oah는 이 앱 없이도 모두 동작한다. Orca는 코딩 에이전트를 각자의 git 워크트리에서 나란히 돌린다. Aside는 AI 에이전트가 들어 있는 브라우저이고 Claude Code와 Codex가 MCP로 웹 작업에 쓴다. 설정은 앱마다 제안하고 사용자가 확인한 것만 설치한다.

필요한 상황

여러 에이전트를 동시에 돌리거나 웹을 쓰게 하면 편하지만, 직접 통제하고 싶은 설정 단계와 계정 위험이 늘어난다.

동작 방식

  1. oah init(또는 python -m oah.setup)이 빠진 앱을 공식 설치 명령과 함께 optional로 보여 주고 묻는다. --yes로는 이 앱을 설치하지 않는다.
  2. python -m oah.setup.companions가 설치된 앱을 연결한다. 모든 단계를 정확한 명령과 함께 먼저 출력하고, 사용자 폴더의 파일을 바꾸는 단계에는 [global]을 붙인다.
  3. Orca는 사용자가 Orca 설정에서 orca 명령을 등록하고, 설정이 Orca의 에이전트 안내서를 더하고 프로젝트를 등록할 수 있다. Orca가 있으면 oah call --launcher orca가 워커를 Orca 터미널에서 실행한다.
  4. Aside는 aside 명령을 설치하고 직접 로그인한 뒤 Claude Code와 Codex용 MCP 서버를 등록한다. 선택 규칙 절은 웹 작업에는 Aside 도구를 쓰고, 페이지 내용은 지시가 아니라 데이터로 다루고, 결제·구매·유료 구독은 절대 확정하지 않게 한다.

예제

설치된 동반 앱을 연결한다. `--app orca`, `--app aside`, `--dry-run`을 붙일 수 있다(동반 앱 문서).

python -m oah.setup.companions

요구 사항

  • Orca는 macOS, Windows, 또는 공식 페이지를 따른 Linux. 에이전트 안내서를 더하려면 Node.js(npx)가 필요하다.
  • Aside는 macOS나 Windows. Linux에서는 돌지 않는다. 무료 요금제가 있다.

한계와 복구

  • oah는 계정 이름, ID, 비밀번호, 토큰을 묻거나 읽거나 출력하거나 저장하지 않는다. 설정은 로그인 상태 칸과 MCP 실행 설정만 본다.
  • oah가 쓸 내용과 다른 기존 MCP 항목은 바꾸지 않았고 확인하지 않았다고 알리며 --yes여도 대기 상태로 둔다.
  • 설정이 기록하는 것은 등록이지 서버가 실행된다는 증명이 아니다.
  • macOS에서는 Homebrew 전체 이름 stablyai/orca/orca를 쓴다. 이름이 “orca”인 무관한 cask가 따로 있다.

원문 문서

관련 기능