이 저장소는 여러 Mac에서 동일한 개발 환경을 쉽게 구성하고 유지하기 위한 개인용 dotfiles 저장소입니다.
새로운 Mac에서도 이 저장소를 내려받고 Nix 설정을 적용하면, 매번 도구와 환경을 처음부터 수동으로 설치하지 않고 익숙한 개발 환경을 재현할 수 있도록 만드는 것이 목표입니다.
- Nix: 개발 도구와 패키지 버전 관리
- nix-darwin: macOS 시스템 설정 관리
- Home Manager: 사용자 환경과 셸 설정 관리
- Homebrew: macOS 애플리케이션과 일부 패키지 관리
- macOS 기본 설정
- CLI 개발 도구
- Homebrew formula 및 cask
- Zsh와 Starship 설정
- WezTerm, Neovim 등 개발 도구 설정
- Neovim의 Lua LSP는 Nix의
lua-language-server와 내장 자동 완성을 사용합니다../rebuild.sh적용 후 Lua 파일을 열면 서버가 시작되며,vim.o.등의 Neovim API를 완성할 수 있습니다.Ctrl-Y로 선택 항목을 확정하고,:checkhealth vim.lsp로 연결 상태를 확인합니다. Mason은 사용하지 않습니다. 내장 자동 완성 메뉴는 기존mini.icons의 종류별 아이콘과 색상을 표시하고, 선택한 항목의 문서는 옆 팝업에 표시합니다. 별도 완성 플러그인은 사용하지 않습니다. - Python LSP는 Nix의
pyrefly를 사용합니다../rebuild.sh적용 후 Neovim을 다시 열면 Python 파일에서 자동으로 시작합니다. 내장 자동 완성과Ctrl-X→Ctrl-O수동 완성을 사용하며Ctrl-Y로 확정합니다. 프로젝트 설정이 없는 파일에도 표준 타입 검사를 적용하고,pyrefly.toml또는[tool.pyrefly]프로젝트 설정을 우선합니다. - YAML (
.yaml,.yml)은 Nix의yaml-language-server, JSON/JSONC는vscode-langservers-extracted의 JSON 서버를 사용합니다../rebuild.sh적용 후 Neovim을 다시 열면 자동 연결되며, 구문 진단과 내장 자동 완성을 제공합니다. 애플리케이션별 설정 키 검증에는 해당 JSON Schema가 필요합니다. - Jupyter 노트북은
jupynvim으로 편집하고 실행합니다. Python 커널은 프로젝트의.venv에 두며 기존 Pyrefly와 내장 자동 완성을 유지합니다. 설치와 이미지 렌더링 제한은 아래 Neovim Jupyter 노트북을 참고하세요. - Neovim UI 플러그인은 기존
lazy.nvim으로 관리합니다. Neovim 0.12 이상에서tiny-cmdline.nvim은:명령줄을 중앙 팝업으로 표시하고 (/,?검색은 하단 유지),modicator.nvim은 모드에 따라 현재 줄 번호 색상을 바꿉니다.nvim-hlslens는 검색 결과에 카운터를 표시하며n,N,*,#,g*,g#를 그대로 사용할 수 있습니다.<leader>l로 검색 강조를 지웁니다. - 파일 검색은
<leader>ff로 현재 작업 디렉터리,<leader>fF로 홈 디렉터리를 검색합니다. 홈 검색은 숨김 파일을 포함하되 ignore 규칙은 유지합니다. Snacks.indent는 중첩 깊이별 색상으로 들여쓰기 가이드를 표시하고 현재 범위를 강조합니다. 애니메이션은 끕니다.rainbow-delimiters.nvim은 Sonokai 색상으로 괄호 쌍을 구분하며, Lua/Python/JSON/YAML 파서도nvim-treesitter로 설치합니다.nvim-autopairs는 괄호와 따옴표를 자동으로 짝지으며, Enter 줄바꿈과Ctrl-Y완성 확정 키는 유지합니다.nvim-ts-autotag는 HTML/JSX/TSX 태그를 자동으로 닫고 이름 변경 시 짝 태그도 갱신합니다. 필요한 HTML/JavaScript/TypeScript/TSX 파서는 기존nvim-treesitter설치 설정에서 관리합니다.
- Neovim의 Lua LSP는 Nix의
- Pi의 모델, 테마, 스킬 및 확장 패키지 기본 설정
비밀번호, API 키, 인증 토큰, 회사 전용 정보처럼 외부에 공유하면 안 되는 값은 이 저장소에 포함하지 않는 것을 원칙으로 합니다. 이러한 정보는 각 Mac에서 별도로 관리합니다.
이 저장소에서 관리하는 에이전트 스킬 목록과 개별 설치 방법은
home/.agents/skills/README.md를
참고하세요. 전체 dotfiles 구성을 적용하지 않아도 원하는 스킬 디렉터리만
에이전트 또는 Codex 기본 설치 도구로 설치할 수 있습니다.
home/.config/nvim/lua/plugins/notebook.lua에서 jupynvim의 안정 릴리스를
사용하며, 실제 버전은 lazy-lock.json으로 고정합니다. .ipynb 읽기 전에
플러그인을 로드해야 하므로 eager loading을 사용합니다. 최초 Neovim 실행 시
Lazy가 설치하며, 필요하면 :Lazy install jupynvim으로 실행할 수 있습니다.
Apple Silicon Mac에서는 upstream 설치기가 Rust 백엔드의 prebuilt와
SHA256SUMS를 내려받아 검증합니다. Prebuilt가 없는 플랫폼에서는 cargo가
필요합니다.
Python 커널은 전역이 아니라 프로젝트 환경에 설치합니다. 기존 uv 프로젝트라면 uv가 설치된 셸에서 프로젝트 디렉터리로 이동한 후 실행합니다:
uv add --dev ipykernel
uv sync
nvim analysis.ipynbuv를 쓰지 않는 프로젝트는 python3 -m venv .venv로 환경을 만들고
.venv/bin/python -m pip install ipykernel로 설치할 수 있습니다.
이미 커널이 있는 .venv는 다시 만들 필요가 없습니다. 플러그인은 노트북의
상위 디렉터리에서 .venv를 자동 탐색하므로 사용자 kernelspec을 별도로
등록하지 않아도 됩니다. Python/uv와 프로젝트 의존성은 각 머신·프로젝트에서
관리하며 이 설정은 전역 Python 환경을 변경하지 않습니다.
새 노트북은 :JupynvimOpen analysis.ipynb으로 생성합니다. 노트북 안에서만
기본 키맵이 적용됩니다 (<leader>는 Space):
<leader>nr또는 Shift+Enter: 셀 실행 후 다음 셀로 이동- Ctrl+Enter: 현재 셀 실행 후 그대로 유지
<leader>nR: 전체 실행<leader>na/<leader>nb: 위 / 아래에 셀 추가<leader>nm/<leader>ny: Markdown / 코드 셀로 변환<leader>nK: 커널 선택,<leader>ni: 중단,<leader>nx: 재시작:w: 코드와 실행 결과 저장
터미널에서 수정키+Enter를 구분하지 못하면 <leader>nr을 사용합니다.
실행 중인 커널의 완성·hover는 jupynvim_kernel LSP가 제공하며, 기존 내장
완성과 Ctrl-Y를 그대로 사용합니다. Pyrefly는 notebook protocol로 연결됩니다.
프로젝트 루트와 .venv를 올바르게 탐지하려면 프로젝트에 pyproject.toml
또는 pyrefly.toml을 두는 것이 좋습니다. 원격 SSH 프로필은 설정하지 않습니다.
이미지는 WezTerm/iTerm2를 고려해 image_renderer = 'chafa'로 설정합니다.
chafa는 Nix로 관리하므로 ./rebuild.sh 적용 후 사용할 수 있습니다.
다만 검증한 jupynvim v0.4.5에는 코드 셀 이미지의 capability 검사 버그가
있어 Kitty/Ghostty가 아닌 터미널에서는 chafa fallback에 도달하지 않습니다.
이 환경에서는 텍스트 출력과 실행·저장은 동작하지만 코드 셀 이미지는 표시되지
않습니다. 이미지 데이터는 .ipynb에 그대로 저장됩니다. Upstream 코드는
수정하거나 monkey-patch하지 않습니다. 실제 그래픽에는 Kitty 또는 Ghostty
1.3+와 image_renderer = 'placeholder' 설정이 필요하며, multiplexer 조합은
별도 확인이 필요합니다.
macOS 공통 창 관리는 heecheon92/AeroSpace의 centered-zoom 브랜치를 사용합니다.
이 브랜치는 upstream v0.21.3-Beta를 바탕으로 하며, Nix가
v0.21.3-centered-zoom.2 릴리스의 미리 빌드된 zip을 고정합니다. 로컬에서
Swift 소스를 빌드하는 순수 Nix 패키지는 아닙니다. 앱은
/Applications/Nix Apps/AeroSpace.app, CLI는
/run/current-system/sw/bin/aerospace에 설치됩니다. Home Manager는
home/.config/aerospace/aerospace.toml을 ~/.config/aerospace/aerospace.toml로
링크합니다. 별도 ~/.aerospace.toml을 함께 만들면 설정 경로가 충돌합니다.
새 Mac에서는 호스트 이름에 따라 Mac-mini 또는 MacBook-Pro 구성을 선택하는
일반 ./rebuild.sh 흐름으로 적용한 뒤 AeroSpace를 실행하고,
시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용에서 허용합니다.
권한은 머신마다 승인하며 Git으로 복제하지 않습니다. ad-hoc 서명된 앱 바이너리가
교체되면 macOS가 손쉬운 사용 권한을 다시 요청할 수 있습니다.
기존 Homebrew 설치에서 전환할 때는 먼저 Nix 패키지 빌드를 확인한 뒤 기존
AeroSpace를 종료하고 brew uninstall --cask aerospace를 실행합니다.
homebrew.onActivation.cleanup = "none"이므로 선언에서 제거된 cask는
자동 삭제되지 않습니다. 새 앱을 실행하기 전에는 Homebrew와 Nix 버전을
동시에 실행하지 않습니다.
로그인 시 자동 실행하며 시스템 설정 창만 floating으로 둡니다. 일반 창은 AeroSpace가 tiling으로 관리하고, 창 안쪽과 화면 가장자리에 16pt 간격을 둡니다. 상단은 SketchyBar 32pt를 포함해 48pt를 예약합니다. 포커스가 다른 모니터로 이동하면 포인터를 옮기며, 마우스가 가리키는 창에도 포커스를 맞춥니다. 숫자·문자 persistent workspace를 유지하되 모니터별 이름이나 앱별 고정 워크스페이스는 지정하지 않습니다.
Option+Enter: 홈 디렉터리에 독립된 WezTerm 인스턴스 열기. 최소 사용자 환경으로 macOS 앱 런처를 호출하고--always-new-process를 사용해, 기존 터미널·Herdr 환경을 상속하거나 실행 중인 WezTerm 프로세스를 재사용하지 않습니다.Option+B/Option+E: 새 Safari 창 / Finder 열기Option+S: 시스템 설정 열기 (이미 실행 중이면 활성화)Option+C: 현재 창 닫기 (마지막 창이면 앱 종료)Option+H/J/K/L: 왼쪽/아래/위/오른쪽 창 포커스- 위 조합에
Shift추가: 창 이동 Option+//Option+,: tiles 방향 전환 / accordion 방향 전환Option+F: AeroSpace 전체 화면 (macOS 기본Ctrl+Cmd+F와 별개)Option+Shift+Z: 현재 창을 화면 중앙의 60% × 70% 크기로 확대/복원 (기본 애니메이션 없음, 필요하면 설정 명령에--animation on추가) 다른 창이나 워크스페이스로 포커스를 옮겨도 중앙 확대 상태를 유지합니다.Option+Shift+F: floating/tiling 전환Option+Shift+T: 현재 워크스페이스 전체를 floating → tiled → grid → floating 순서로 전환합니다. floating 창이 섞여 있으면 먼저 모두 tiled로 정리하며, 빈 워크스페이스는 변경하지 않습니다.Option+1…9: 워크스페이스의 모니터 배치를 유지한 채 해당 워크스페이스로 이동Ctrl+Option+1…9: 선택한 워크스페이스 전체를 현재 포커스된 모니터로 가져와 전환Option+Shift+1…9: 현재 창만 해당 워크스페이스로 이동Option+[/Option+]: 모든 모니터의 이전/다음 워크스페이스로 순환 이동; 워크스페이스를 옮기지 않고 해당 모니터로 포커스만 이동합니다.Option+Shift+[/Option+Shift+]: 현재 포커스된 모니터 안에서만 이전/다음 워크스페이스로 순환 이동 (두 방식 모두 빈 워크스페이스와 문자 이름을 포함하며 양 끝에서 순환)Option+Tab: 직전 워크스페이스로 전환Option+Shift+Tab: 현재 워크스페이스를 다음 모니터로 이동Option+R: 크기 조정 모드;H/J/K/L로 조정, Enter/Escape로 종료Option+Shift+;: service mode 진입
service mode에서는 Escape로 설정을 다시 읽고 main mode로 돌아갑니다.
R은 workspace 트리를 평탄화하고, F는 floating/tiling을 전환하며,
Backspace는 현재 창을 제외한 모든 창을 닫습니다. Option+Shift+H/J/K/L은
해당 방향의 컨테이너와 결합하며, 각 명령 뒤 main mode로 돌아갑니다.
전체 레이아웃 전환은 home/bin/aerospace-cycle-layout이 담당하며 Home Manager가
~/.local/bin/aerospace-cycle-layout로 링크합니다. 이미 관리하는 Bun 런타임을
사용하므로 별도 패키지는 필요 없습니다. 새 머신에서는 ./rebuild.sh로 링크를 적용합니다.
tiled는 균등한 가로 타일로 정리합니다. 한 창에 집중하려면 Option+F를 사용합니다.
grid는 floating 창의 좌표를 조작하는 대신 실제 중첩 타일 컨테이너를 만듭니다.
창 3개는 위 1개·아래 2개, 4개는 2×2, 5개는 위 2개·아래 3개로 배치하고
행 높이와 각 행의 열 너비를 균등하게 맞춥니다. 창 순서는 전환 시작 시
AeroSpace가 반환하는 목록을 따릅니다. 각 전환은 기존 수동 그룹·크기 설정을 다시 구성합니다.
창이 1–2개이면 grid와 tiled가 비슷하게 보일 수 있습니다. 이를 구별하기 위한
마지막 단계와 창 ID/레이아웃 정보는 사용자 임시 디렉터리의
aerospace-cycle-layout-<uid> 아래에만 저장하며 Git으로 관리하지 않습니다.
창 구성이나 레이아웃이 바뀌어 기록과 다르면 현재 상태를 기준으로 다시 판단합니다.
빠르게 연속 입력해도 같은 워크스페이스의 변경은 순차 실행합니다.
앱이 최소 창 크기를 강제하면 실제 창이 할당된 타일보다 커져 겹칠 수 있습니다. grid가 앱의 최소 크기를 무시하지는 못합니다. 이 경우 디스플레이의 “공간 더 보기” 배율을 사용하거나, 더 작은 창을 지원하는 앱/브라우저 버전을 사용해야 합니다.
WezTerm에서도 tiling과 전체 화면은 AeroSpace가 담당합니다.
home/.config/wezterm/wezterm.lua는 AeroSpace가 새 창 열기에 사용하는
Option+Enter의 WezTerm 기본 할당만 해제하고 나머지 기본 단축키는 유지합니다.
WezTerm의 simple fullscreen은 메뉴 막대를 자동 숨기므로 함께 사용하지 않습니다.
전역 키는 동일한 앱 단축키보다 우선합니다. OMP와 충돌하는 Option+R
(재시도), Option+L (화면 초기화), Option+Shift+L (현재 줄 복사)는 의도적으로
AeroSpace에 우선권을 줍니다. 반면 OMP의 Option+P, Option+M, Ctrl+S는
AeroSpace에 할당하지 않아 그대로 사용할 수 있습니다. OMP 키맵 자체는 변경하지
않습니다. 크기 조정 모드에서는 일반 H/J/K/L 입력도 AeroSpace가 처리하므로
작업 후 Enter/Escape로 빠져나옵니다.
설정 파일 저장 시 자동으로 다시 읽습니다. auto-reload-config를 처음 켠 뒤에는
aerospace reload-config를 한 번 실행해야 하며, 변경 전 검사는
aerospace reload-config --dry-run --no-gui --warnings-as-errors를 사용합니다.
상단은 SketchyBar로 표시하고, macOS 기본 메뉴 막대와 하단 Dock은 자동으로
숨깁니다. Apple 메뉴와 앱 메뉴는 화면 맨 위로 포인터를 올리면 나타납니다.
configuration.nix의 _HIHideMenuBar = true,
AppleMenuBarVisibleInFullscreen = false, dock.autohide = true가 원본입니다.
실행 중인 앱이 이전 전체 화면 설정을 유지하면 전체 화면을 나갔다가 다시
들어가거나 앱을 다시 실행합니다.
upstream main은 수정하지 않습니다. 새 버전은 centered-zoom 브랜치를 선택한
upstream 릴리스 태그 위로 rebase하고 테스트한 뒤, upstream 빌드 스크립트로
릴리스 zip을 만듭니다. 새 태그와 asset을 fork에 게시하고
packages/aerospace.nix의 version과 hash를 갱신한 다음 ./rebuild.sh를
실행합니다. Nix가 고정한 릴리스만 설치되므로 자동 업데이트를 보장하지 않습니다.
릴리스 빌드는 upstream의 build-release.sh --build-version VERSION --codesign-identity -를
사용하며 Xcode와 upstream 개발 문서의 빌드 의존성이 필요합니다.
hash는 zip 파일 자체의 SHA-256이 아니라 nix-prefetch-url --unpack 결과를
nix hash convert --hash-algo sha256 --to sri로 변환한 unpacked 해시입니다.
configuration.nix에서 Homebrew의 felixkratz/formulae/borders를 설치합니다.
macOS 14 이상에서 동작하며, AeroSpace의 after-startup-command가 로그인 후
실행합니다. 시작 주체를 하나로 유지하기 위해 brew services start borders는
사용하지 않습니다. 별도 bordersrc 없이 모양도 같은 startup 명령에서 관리합니다.
기본 모양은 둥근 10pt 테두리, HiDPI 켜짐, 활성 창은 밝은 cyan 0xff00e5ff,
비활성 창은 0xff494d64입니다. 색은 0xAARRGGBB 형식입니다.
기존 WezTerm의 비활성 창 흐림 효과는 그대로 유지합니다.
after-startup-command는 AeroSpace 시작 때 실행되므로 설정 파일을 저장하거나
reload-config만 실행해도 테두리 옵션이 다시 적용되는 것은 아닙니다.
모양을 바꿀 때는 startup 명령의 옵션을 수정한 뒤 같은 명령을 터미널에서
실행하면 현재 프로세스에 즉시 반영됩니다:
borders style=round width=10.0 hidpi=on \
active_color=0xff00e5ff inactive_color=0xff494d64이미 실행 중이면 위 명령은 새 상주 프로세스를 만들지 않고 기존 인스턴스를
갱신합니다. 새 Mac에서는 ./rebuild.sh 적용 후 AeroSpace를 실행하면 됩니다.
configuration.nix에서 felixkratz/formulae/sketchybar를 설치하고 Home Manager가
home/.config/sketchybar를 ~/.config/sketchybar로 링크합니다.
AeroSpace의 after-startup-command가 실행하므로 별도
brew services start sketchybar는 사용하지 않습니다.
모든 디스플레이 상단에 32pt 어두운 막대를 표시합니다. 왼쪽에는 AeroSpace
워크스페이스와 현재 앱, 오른쪽에는 음량과 날짜·시간을 표시합니다.
숫자 1–9는 항상 표시하며, 문자 워크스페이스는 창이 있거나 포커스되었을 때
표시합니다. 선택한 워크스페이스는 JankyBorders와 같은 cyan으로 강조하며
클릭하면 해당 워크스페이스로 이동합니다. macOS 기본 Spaces 번호와는 다릅니다.
막대 클릭은 기존 모니터의 워크스페이스로 포커스를 옮깁니다. 현재 모니터로
워크스페이스를 가져오려면 Ctrl+Option+1…9를 사용합니다.
표시 이름은 현재 창 목록에서 자동으로 만듭니다. 예를 들어 서로 다른 앱 3개가
있는 워크스페이스는 5 ChatGPT · Claude +1처럼 표시합니다. 같은 앱의 여러
창은 한 번만 세고, 앱 이름을 정렬한 뒤 최대 2개와 나머지 앱 수를 표시합니다.
긴 앱 이름은 각각 14자 이내로 줄이며, 빈 워크스페이스는 번호만 표시합니다.
실제 워크스페이스 이름과 단축키는 바뀌지 않습니다.
설정 원본은 home/.config/sketchybar/sketchybarrc, 항목 동작은 같은 디렉터리의
plugins/*.sh입니다. 별도 Lua 런타임이나 플러그인 프레임워크는 사용하지 않습니다.
sketchybar --hotload on으로 설정 디렉터리의 변경을 감시하므로 설정이나
플러그인 스크립트를 저장하면 자동으로 다시 읽습니다. 수동으로 다시 구성하려면:
sketchybar --reload워크스페이스 전환은 AeroSpace의 exec-on-workspace-change 이벤트로 반영합니다.
앱·창·디스플레이 이벤트에도 표시를 갱신하고, 이벤트가 없는 창 이동 등은
5초 간격으로 현재 상태를 다시 읽어 반영합니다. 길이 제한은
plugins/workspaces.sh의 truncate_app, 주기는 sketchybarrc의
workspace_controller에 지정한 update_freq에서 조정합니다.
새 워크스페이스 이름을 추가한 경우에도 sketchybar --reload로 버튼을 다시 만듭니다.
막대 높이를 바꾸면 AeroSpace의 gaps.outer.top도 높이 + 16에 맞춥니다.
새 Mac에서는 ./rebuild.sh 적용 후 AeroSpace를 실행합니다.
SketchyBar는 디스플레이마다 개별 Spaces가 켜져 있어야 하므로
com.apple.spaces의 spans-displays = false를 관리합니다. 이 설정을 이전에
꺼 두었다면 적용 후 로그아웃·로그인이 필요할 수 있습니다.
기본 메뉴 막대는 삭제되지 않으며 화면 위쪽에 포인터를 올려 계속 사용할 수 있습니다.
iTerm의 기존 Hotkey Window 프로필은
home/.config/iterm2/hotkey-window.json에서 Dynamic Profile로 계속 관리하며,
보조 터미널 단축키로 Ctrl+Option+\``를 사용합니다. Home Manager가 iTerm의 DynamicProfiles디렉터리를 링크하며, 변경은./rebuild.sh로 적용합니다. 왼쪽 Option은 Esc+, 오른쪽 Option은 Normal`로 유지합니다.
Herdr에서 prefix+t를 누르면 기본 ~/.zprofile과 ~/.zshrc 대신
~/.config/zsh/scratch의 경량 Zsh 프로필을 사용하는 팝업 터미널을 엽니다.
일반 셸은 FNM, 스크래치 셸은 롤백 기준으로 기존 NVM을 사용하며 어느 쪽도
Node 관리자를 시작 시 초기화하지 않습니다. 일반 셸은 fnm, Node 패키지
명령, 관리되는 전역 CLI 중 하나를 처음 실행할 때 FNM과 현재 디렉터리의
Node 버전을 활성화합니다. 스크래치 셸은 기존 NVM
로더를 그대로 유지합니다. Conda도 두 셸에서 첫 conda 명령이 현재 셸에 훅을
로드합니다. 런타임 버전과 전역 패키지는 각 머신에 로컬로 유지하며, 프로필과
로더 원본은 home/.config/zsh에서 관리하고 Home Manager가 링크합니다.
일반 셸과 스크래치 셸은 OMP 상태 표시줄의 구성을 본뜬 공통 Starship
프롬프트를 사용해 호스트, 현재 디렉터리, Git 상태와 명령 실행 시간을 표시합니다.
일반 Zsh와 Herdr scratch shell에서 Ctrl+R을 누르면 FZF가 shell history를
fuzzy-search하는 selector를 엽니다. 검색 결과를 선택하면 command line에
삽입되며 바로 실행되지 않으므로 검토하거나 수정한 뒤 Enter를 누릅니다. 일반
Zsh는 첫 prompt가 표시된 뒤 다른 UI helper와 함께 widget을 lazy-load합니다.
Scratch shell은 시작 성능을 유지하기 위해 첫 Ctrl+R 입력 시에만 widget을
load합니다. 두 shell 모두 Ctrl+T와 Alt+C는 FZF에 할당하지 않습니다.
일반 셸의 eager/lazy 경계, 스크래치 셸과의 벤치마크 방법, 새 SDK나
completion을 추가할 때의 판단 기준, 검증 및 롤백 절차는
ZSH_PERFORMANCE.md를 참고하세요. 각 Mac에서
dotfiles 작업을 위임받은 에이전트는 Zsh 변경 전에 이 문서를 읽어야 합니다.
Codex 사용량을 아껴야 할 때는 ob Zsh alias로 OMP를 실행합니다. 이 설정은
기본 설정과 인증·세션 상태는 그대로 공유하면서
home/.omp/agent/config-budget.yml의 저비용 모델 역할과 fallback만 현재
프로세스에 덮어씁니다. 일반 omp 실행은 기존 고성능 모델 구성을 유지합니다.
ob기본(default)·slow·task 역할은 OpenRouter GLM 5.3 flash max를 사용하고, smol·vision·commit 역할은 Luna, plan 역할은 Terra, advisor 역할은 Sol high를 유지합니다. fallback에는 Sol을 넣지 않아 지원 역할이 예기치 않게 고비용 모델로 복귀하지 않습니다.
Lavish CLI는 packages/lavish-axi.nix에서 version을 pin하며 ./rebuild.sh로
설치합니다. 사용자가 HTML review를 명시적으로 요청했을 때만
lavish-axi <html-file>로 실행합니다.
Lavish bundled skill은 전역 skill 목록에 연결하지 않고, Claude Code, Codex,
OpenCode 및 GitHub Copilot CLI의 SessionStart hook이나 OMP ambient-context
extension도 등록하지 않습니다. lavish-axi setup hooks를 실행하면 자동 주입이
다시 설치되므로 실행하지 않습니다. 기존 hook을 제거한 뒤에는 실행 중인 harness를
재시작하고 새 대화를 시작해야 이미 로드된 지침이 남지 않습니다.
Lavish를 올릴 때는 Nix expression의 version과 npm tarball hash, 그리고
packages/lavish-axi/package.json 및 package-lock.json의 dependency lock을
함께 갱신합니다.
home/bin/omp_parallel_bench는 여러 OMP 모델을 tmux pane에서 동시에
실행하는 개인용 벤치마크 명령입니다. ./rebuild.sh를 실행하면
omp_parallel_bench 명령으로 사용할 수 있습니다.
omp_parallel_bench "/Users/heecheonpark/Git/agent-swarm"
omp_parallel_bench "/Users/heecheonpark/Git/agent-swarm" -v
omp_parallel_bench "/Users/heecheonpark/Git/agent-swarm" -o bench
omp_parallel_bench "/Users/heecheonpark/Git/agent-swarm" -o ./logs/omp-bench -v-o/--output을 지정한 경우에만 모델별 로그를 저장합니다. -v/--view를
지정하면 벤치마크를 시작한 뒤 해당 tmux 세션을 즉시 표시합니다. tmux는
Home Manager가 설치하며, omp 실행 파일은 별도 OMP 설치가 필요합니다.
현재 Mac의 호스트 이름에 맞는 nix-darwin 구성을 적용합니다.
./rebuild.sh현재 회사 Mac용 Mac-mini 프로필과 개인 Mac용 MacBook-Pro 프로필이
정의되어 있습니다. 다른 Mac에서 사용하기 전에는 해당 Mac의 호스트
이름과 환경에 맞는 별도 프로필을 flake.nix에 추가해야 합니다.
rebuild.sh는 현재 사용자로 Git이 추적하는 flake 스냅샷을 Nix store에
고정한 뒤 관리자 권한으로 활성화합니다. root의 Git 소유권 검사 때문에
safe.directory 예외를 추가할 필요가 없습니다. 새 Nix 파일은 git add로
추적 대상에 포함한 뒤 재빌드합니다.
자세한 설치, 동기화, 복구 절차는 SYNC_GUIDE.md를 참고하세요.