Quick Reference

새 Worktree가 만들어질 때 자동 준비한다 -> setup script
사람이 눌러 반복 명령을 실행한다        -> Action
OS별 shell·경로가 다르다                -> macOS/Windows/Linux override
팀과 같은 설정을 쓴다                   -> project root/.codex를 Git에 포함

Local environments는 ChatGPT desktop app의 Codex에서만 쓴다. 프로젝트별 setup script와 Actions를 설정 pane에서 만들면 .codex folder에 저장되고, repository에 commit해 팀과 공유할 수 있다.

Setup script는 새 Worktree를 준비한다

Worktree는 Local chat과 다른 directory에서 시작하므로 node_modules, build output, Git에 넣지 않은 설정이 없을 수 있다. setup script는 새 Worktree chat을 만들 때 자동 실행되며, 의존성 설치와 필요한 초기 build를 여기 둔다.

# setup script
npm install
npm run build

setup script는 환경을 사용할 수 있는 상태로 만드는 명령만 둔다. 전체 test suite처럼 오래 걸리고 사람이 실패를 해석해야 하는 검증을 넣으면 새 Worktree 시작이 느려지고, 준비 실패와 제품 실패를 구별하기 어려워진다. 명령이 OS에 따라 다르면 macOS, Windows, Linux별 override를 설정한다.

Actions는 반복 검증을 빠르게 실행한다

Action은 development server 시작, test, build처럼 자주 쓰는 명령을 desktop app 상단 bar에 둔다. 실행은 integrated terminal에서 이뤄진다. 일회성 debugging은 terminal에서 직접 실행하고, chat이나 팀원이 계속 반복하는 명령만 Action으로 등록한다.

# Action: Test
npm test

monorepo에서는 .codex를 공유할 project directory를 실제로 열어야 한다. repository root를 열었다고 해도 Local environment가 있는 하위 project를 열지 않으면 팀 설정이 적용되지 않을 수 있다. 설정을 commit하기 전에는 다른 OS에서도 명령이 성립하는지 확인하고, 개인 API key나 로컬 절대 경로는 shared .codex에 넣지 않는다.