Local environments와 Actions

기본 패턴

로컬 환경이 담당하는 것
- setup script: 새 Worktree 준비
- action: 자주 쓰는 명령을 상단 버튼으로 등록
- platform override: macOS, Windows, Linux별 스크립트 분기

공유 규칙
- 설정은 프로젝트 루트의 .codex 아래에 둔다
- monorepo에서는 해당 .codex 가 있는 프로젝트 디렉터리를 열어야 한다

설명

• Local environments는 Codex app에서 프로젝트마다 반복되는 준비 작업을 정리하는 층입니다.
• setup script는 새 Worktree가 만들어질 때 자동으로 실행됩니다. 의존성 설치, 초기 빌드, 생성 파일 준비처럼 "격리된 디렉터리에서는 빠지기 쉬운 준비 단계"를 보완할 때 유용합니다.
• action은 개발 서버 실행, 테스트 실행, 린트 실행처럼 자주 쓰는 명령을 상단 버튼으로 올려 두는 기능입니다. 반복 명령을 매번 다시 입력하지 않아도 되고, 실행 위치도 통합 터미널과 자연스럽게 연결됩니다.
• 공식 문서는 이 설정을 프로젝트 루트의 .codex 폴더에 저장하고, 필요하면 저장소에 커밋해 팀과 공유할 수 있다고 설명합니다.

짧은 예제

# setup script 예시
npm install
npm run build

# action 예시
npm test

빠른 정리

주의할 점