OMP 설정, 쉽게 이해하기

OMP(oh-my-pi)를 쓰다 보면 /settings 화면이 낯설게 느껴질 때가 있습니다. 이 페이지는 그 화면의 설정을 한곡에 모아 풀어놓은 노트입니다. 항목을 누르면 그 설정이 무엇을 바꾸는지, 타입과 기본값, ~/.omp/agent/config.yml에 적을 정확한 키가 나옵니다. ⌘K를 누르면 모든 탭에서 한 번에 찾을 수 있어요.

값은 어떻게 정해지나

이 문서는 스키마 기본값을 보여줍니다. 아래 목록에서 더 아래 층이 이깁니다. 그래서 여기서 본 값이라도 설정 파일, 플래그, 환경 변수가 그 값을 덮어쓸 수 있어요.

  1. 스키마 기본값이 문서가 보여주는 내장 기본값
  2. 전역 설정~/.omp/agent/config.yml
  3. 프로젝트 설정현재 작업 디렉터리의 .omp/config.yml
  4. CLI 오버레이--config로 넣은 파일, 넣은 순서대로 적용
  5. 런타임 오버라이드전용 플래그와 기능별 환경 변수

/settings와 omp config set은 전역 설정에만 기록합니다. 프로젝트 설정은 손으로 직접 고쳐야 하고, 환경 변수는 한 층이 아니라 기능마다 따로 놓입니다.

키, 타입, 기본값은 OMP 공식 스키마에서 가져왔고, 한국어 설명은 SingandMong Studio가 이해를 돕도록 새로 썼습니다. 원본 가이드의 편집 조언은 담지 않았습니다.

설정 파일에서만 다루는 항목

스키마에는 있는데 패널에는 일부러 빠진 항목들입니다. 선택지가 정해지지 않은 숫자·리스트 설정은 위젯으로 만들 수 없어서, YAML 파일에서 직접 고쳐야 합니다.

키타입기본값하는 일

키, 타입, 기본값은 OMP 스키마(공식 설정 문서, MIT 라이선스, can1357/oh-my-pi, 스키마 v, 기준일 2026-08-24)에서 가져왔습니다. 한국어 설명은 SingandMong Studio가 새로 썼고, 페이지 구성은 OMP Settings Demystified(@wolfie_)를 참고했습니다.