START ON YOUR MAC
필요한 도구를 고르고, Mac 터미널에서 두 줄을 실행하세요.
계정 연결과 첫 실행은 선택한 도구에 맞춰 안내합니다.
INSTALL / MACOS
셋을 함께 써도, 하나부터 시작해도 좋습니다.
설치할 도구를 고르면 명령이 바뀝니다.
macOS 13 이상 Apple Silicon / Intel 공개 프리뷰
2026.10.08 업데이트 · 모델 목록 자동 조회 · 실행 안정성 개선 · 개인별 테마 설정
세 도구의 실행 파일 6개를 함께 설치합니다.
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh --tool all좌우로 스크롤하면 두 명령의 전체 내용을 볼 수 있습니다.
위의 두 줄을 Mac 터미널에 붙여넣으세요. 관리자 암호나 GitHub 로그인은 필요 없습니다.
gdmuxgdmuxdgdmuxctlgdmux-remotegidgdmAFTER INSTALL / FIRST RUN
Mac에서 설치 명령을 실행한 뒤
선택한 도구의 안내를 따라가세요.
준비할 것: Mac 터미널. 24비트 색상을 지원하는 최신 터미널을 권장합니다.
gdmuxCtrl+B를 누른 뒤 a로 새 작업을 실행하세요. Ctrl+B 다음 v 또는 s로 화면을 나눕니다.
Ctrl+B 다음 w는 전체 작업, ?는 단축키 도움말입니다.
모두 설치에는 gid가 포함됩니다. gdmux 안에서 gid를 실행하기 전, gid의 계정 연결 안내도 확인하세요.
준비할 것: 공식 Codex 또는 Claude CLI와 해당 서비스 계정. 먼저 공식 CLI를 설치하세요.
gid auth status아래에서 사용할 서비스의 명령 하나를 실행하세요.
gid login codex
# 또는
gid login claude작업할 프로젝트 폴더에서 사용할 서비스에 맞춰 실행하세요.
Codex:
gidClaude:
gid --provider claude설치만으로 AI 계정이 생성되거나 로그인되지는 않습니다. gdmux 안에서는 Ctrl+B 다음 a로 gid를 선택할 수 있습니다.
준비할 것: CLI로 직접 쓰려면 작업할 프로젝트. AI에게 작업을 요청하려면 별도로 Codex 또는 Claude와 gdm 스킬이 필요합니다.
gdm --help
gdm doctor원한다면 gdm 스킬을 추가해 AI에게 작업을 요청할 수 있습니다. CLI로 직접 사용하려면 gdm --help에서 명령을 확인하세요.
스킬을 설치했다면 프로젝트에서 Codex 또는 Claude 세션을 새로 시작하세요.
Codex에서:
$gdm-go 로그인 오류를 수정하고 검증까지 완료해줘Claude Code에서:
/gdm-go 로그인 오류를 수정하고 검증까지 완료해줘스킬을 Pi에서 사용하려면 Pi를 별도로 설치한 뒤 gdm-pi로 시작하세요. AI에게 일상 작업을 요청할 때는 gdm-go부터 사용할 수 있습니다.
기본 설치 경로는 ~/.local/bin입니다. 설치 후 새 터미널을 열고 선택한 도구를 실행하세요.
command not found가 나오면 셸 설정 파일(기본 zsh는 ~/.zshrc)에 아래 줄을 추가하고 새 터미널을 여세요. PATH는 터미널이 실행 파일을 찾는 경로입니다.
export PATH="$HOME/.local/bin:$PATH"다른 경로는 설치 명령에 --prefix /절대/경로를 추가해 지정할 수 있습니다. iPhone에서 새 gid 작업을 만들려면 gid는 기본 경로에 설치하세요. 현재 ~/.local/bin/gid를 찾습니다.
기본 설치는 실행 파일과 라이선스 안내만 설치합니다. 셸 시작 파일이나 AI 에이전트 설정은 바꾸지 않습니다.
스킬을 선택하면 Codex·Claude·Pi용 gdm 스킬, gdm-pi 실행기와 Codex 작업 게이트를 추가합니다. 작업 게이트는 AI 작업이 끝날 때 검증 결과를 확인하는 hook입니다.
기존 gdm 스킬을 업데이트하고, 기존 Codex hook은 보존·백업합니다. 필요하면 셸 설정에 ~/.local/bin PATH를 추가합니다. 다른 에이전트의 로그인 정보는 복사하지 않습니다. 설치 후 AI 세션을 새로 시작하세요.
아래 링크는 설치 명령을 실행하지 않고 압축 파일만 받습니다. 압축을 푼 뒤 bin/의 실행 파일을 원하는 경로에 직접 배치하세요.
배포 버전: preview-20261008.3. 앱의 버전 번호가 같아도 배포 날짜와 빌드는 달라질 수 있습니다.
KEEP GOING
업데이트부터 계정 연결까지,
필요할 때 다시 찾아보세요.
설치할 도구를 선택하고 같은 설치 명령을 다시 실행하세요. 선택하지 않은 도구의 기존 설치는 유지됩니다.
실행 중인 gdmux 세션은 기존 백그라운드 프로그램을 계속 사용합니다. 작업을 마친 뒤 모든 세션을 닫고 gdmux를 새로 시작하면 새 버전이 적용됩니다. 설치기가 실행 중인 작업을 종료하지는 않습니다.
설치 명령으로 이동기기 언어가 한국어이면 한국어로, 그 외에는 영어로 시작합니다. 직접 선택한 언어는 저장됩니다. 화면 언어만 바꾸며, 터미널 출력·파일·대화 내용과 AI 답변 언어는 바꾸지 않습니다.
iPhone 앱의 전체 영어 지원과 앱 내 언어 선택은 다음 업데이트에 포함될 예정입니다. 현재 App Store 버전은 일부 화면만 영어를 지원합니다.
소개 페이지는 위쪽 지구본 아이콘의 언어 메뉴에서 전환합니다. 공유한 /en/ 주소는 항상 영어로 열리며, 도구 선택과 현재 위치도 유지합니다.
gdmux: Ctrl+B 다음 p로 명령 팔레트를 열고 language 또는 언어를 검색하세요. Language: English / Language: 한국어 / Language: Auto / 자동에서 고릅니다. 선택은 바로 적용되고 개인 설정에 저장됩니다.
gid: 대화에서 /language en 또는 /language ko를 입력하면 개인 기본값으로 저장합니다. /language auto는 고정 선택을 해제하고 기기 언어를 따릅니다.
gdm: gdm language en 또는 gdm language ko로 기본값을 저장합니다. gdm language auto로 자동 선택에 돌아갑니다. 이번 실행에만 적용하려면 아래처럼 실행하세요.
gdmux --language en
gid --language en
gdm --language en --helpgid의 기본 엔진은 공식 Codex·Claude CLI에서 모델 목록을 자동으로 조회합니다. /model을 열거나 r을 누르면 갱신하고, 목록 화면을 열어 두면 15분마다 다시 확인합니다.
새 모델을 목록에 추가하기 위해 매번 gid를 다시 설치할 필요는 없습니다. 다만 공식 CLI가 새 모델을 제공해야 하므로, 목록이 오래됐다면 해당 CLI도 업데이트하세요. 목록에 표시되더라도 실제 사용 가능 여부는 계정과 서비스의 응답에 따라 달라집니다.
조회 실패 시 마지막 정상 목록을 유지하며, 저장된 목록도 없으면 기본 모델 별칭을 표시합니다. 새 모델이 나타나도 현재 선택과 기본값은 자동으로 바뀌지 않습니다. 원하는 모델을 고른 뒤 s 또는 /model save로 기본값을 저장하세요.
네. gdmux와 gid는 각 사용자의 홈 폴더에 있는 설정을 읽습니다. 처음 설치하면 Tokyo Night로 시작하며, 이미 선택한 테마는 유지됩니다. 아래는 기본 설정 경로 기준입니다. 설정 파일을 먼저 백업하고, 기존 항목을 남긴 채 필요한 값만 합치세요.
선택형 스킨 예시: Black Glass. 아래 파일은 개인 취향에 맞게 색상을 바꾸는 예시입니다. 소개 화면은 기본 테마를 사용하며, 이 스킨은 원하는 경우에만 적용하세요.
gid: ~/.config/gid/config.json의 ui.theme에서 테마를 선택합니다. 아래는 해당 항목만 보여주는 예시입니다.
{
"ui": { "theme": "black-glass" }
}gid용 Black Glass JSON 받기 ↓ · 받은 파일을 ~/.config/gid/themes/black-glass.json에 저장하세요. 파일을 둔 뒤 대화에서 /theme black-glass로 선택할 수도 있습니다. 프로젝트의 .gid/settings.json에 테마가 있으면 개인 설정보다 우선합니다.
gdmux: ~/.config/gdmux/config.toml에서 [theme]와 [theme.colors]를 바꿉니다. gdmux용 Black Glass TOML 받기 ↓의 두 테마 섹션을 기존 파일에 합치세요. 같은 섹션을 중복으로 추가하거나 파일 전체를 덮어쓰지 마세요. 다음에 gdmux 화면을 열 때 적용됩니다.
반투명 배경: Black Glass의 바탕은 터미널 배경을 따릅니다. Ghostty에서 검정 배경과 투명도를 설정하면 바탕이 비치며, 글자를 읽는 패널은 어두운 불투명 색상을 유지합니다. 아래 값은 Ghostty 설정 예시이며 스킨 파일만으로 터미널 설정이 바뀌지는 않습니다.
background = 000000
background-opacity = 0.7
background-blur = true터미널이 투명 배경을 지원해야 하며 macOS의 네이티브 전체 화면에서는 불투명하게 보일 수 있습니다. gdmux를 --theme 또는 GDMUX_THEME로 실행하면 파일의 사용자 색상 대신 지정한 기본 테마가 적용됩니다.
기본 경로 기준으로, 제거할 도구의 실행 파일만 직접 삭제하세요. 아래 명령은 안내용이며 이 페이지에서 실행되지 않습니다.
gdmux와 함께 설치되는 실행 파일 4개:
rm ~/.local/bin/gdmux ~/.local/bin/gdmuxd ~/.local/bin/gdmuxctl ~/.local/bin/gdmux-remotegid와 gdm을 모두 제거할 때:
rm ~/.local/bin/gid ~/.local/bin/gdm둘 중 하나만 제거하려면 해당 실행 파일 경로만 남기세요. 다른 경로에 설치했다면 실제 설치 경로를 사용하세요.
작업·대화·계정 설정과 별도로 설치한 gdm 스킬은 남습니다. 스킬까지 제거하려면 에이전트 설정의 gdm hook을 먼저 해제하고 각 에이전트의 gdm-* 스킬을 삭제하세요. 다른 hook은 유지하세요.
gid의 AI 기능에는 공식 Codex 또는 Claude CLI와 해당 서비스 로그인이 필요합니다. gid auth status로 상태를 확인하고, 사용할 서비스에 따라 gid login codex 또는 gid login claude를 실행하세요.
이 설치에는 AI 서비스 이용권이 포함되지 않습니다. 로그인되지 않는다면 해당 공식 CLI의 로그인 상태도 확인하세요.
gid 첫 실행 안내macOS 13 이상에서 Apple Silicon과 Intel을 지원하는 공개 프리뷰입니다. 공개 실행 파일은 Developer ID 서명과 Apple 공증을 마쳤습니다. Rust·Bun 설치나 GitHub 로그인 없이 설치할 수 있습니다.
소스 저장소는 현재 private입니다. Windows·Linux용 공개 설치 파일은 아직 제공하지 않습니다.
iOS 17 이상에서 App Store의 gdmux 앱을 무료로 다운로드하세요. 원격 작업에는 켜져 있고 네트워크에 연결된 Mac과 연결 프로그램이 필요합니다.
Mac에서 아래 명령을 실행하고 안내에 따라 계정과 Mac을 연결합니다. iPhone 앱에서도 같은 계정을 사용하세요. gdmux 안에서는 Ctrl+B 다음 m으로 연결 설정을 열 수 있습니다.
gdmux --remoteiPhone에서 새 gid 작업을 만들려면 gid를 별도로 설치하거나 모두 설치를 선택하세요. 현재 Mac의 ~/.local/bin/gid를 사용하므로 기본 경로에 설치해야 합니다.
START ON YOUR MAC
필요한 도구를 고르고, Mac 터미널에서 두 줄을 실행하세요.
계정 연결과 첫 실행은 선택한 도구에 맞춰 안내합니다.
INSTALL / MACOS
셋을 함께 써도, 하나부터 시작해도 좋습니다.
설치할 도구를 고르면 명령이 바뀝니다.
macOS 13 이상 Apple Silicon / Intel 공개 프리뷰
2026.10.08 업데이트 · 모델 목록 자동 조회 · 실행 안정성 개선 · 개인별 테마 설정
gdmux와 작업 관리·원격 연결에 필요한 실행 파일 4개를 설치합니다.
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh --tool gdmux좌우로 스크롤하면 두 명령의 전체 내용을 볼 수 있습니다.
위의 두 줄을 Mac 터미널에 붙여넣으세요. 관리자 암호나 GitHub 로그인은 필요 없습니다.
gdmuxgdmuxdgdmuxctlgdmux-remotegdm 스킬은 모두 설치 또는 gdm을 선택할 때 추가할 수 있습니다.
AFTER INSTALL / FIRST RUN
Mac에서 설치 명령을 실행한 뒤
선택한 도구의 안내를 따라가세요.
준비할 것: Mac 터미널. 24비트 색상을 지원하는 최신 터미널을 권장합니다.
gdmuxCtrl+B를 누른 뒤 a로 새 작업을 실행하세요. Ctrl+B 다음 v 또는 s로 화면을 나눕니다.
Ctrl+B 다음 w는 전체 작업, ?는 단축키 도움말입니다.
Ctrl+Q로 화면에서 나가도 백그라운드 세션 관리 프로그램이 실행 중이면 작업 프로세스는 계속 실행됩니다.
gdmux에서 gid 작업을 선택하려면 gid도 설치해야 합니다. iPhone 연결은 아래 FAQ에서 준비 상태를 확인하세요.
기본 설치 경로는 ~/.local/bin입니다. 설치 후 새 터미널을 열고 선택한 도구를 실행하세요.
command not found가 나오면 셸 설정 파일(기본 zsh는 ~/.zshrc)에 아래 줄을 추가하고 새 터미널을 여세요. PATH는 터미널이 실행 파일을 찾는 경로입니다.
export PATH="$HOME/.local/bin:$PATH"다른 경로는 설치 명령에 --prefix /절대/경로를 추가해 지정할 수 있습니다. iPhone에서 새 gid 작업을 만들려면 gid는 기본 경로에 설치하세요. 현재 ~/.local/bin/gid를 찾습니다.
기본 설치는 실행 파일과 라이선스 안내만 설치합니다. 셸 시작 파일이나 AI 에이전트 설정은 바꾸지 않습니다.
스킬을 선택하면 Codex·Claude·Pi용 gdm 스킬, gdm-pi 실행기와 Codex 작업 게이트를 추가합니다. 작업 게이트는 AI 작업이 끝날 때 검증 결과를 확인하는 hook입니다.
기존 gdm 스킬을 업데이트하고, 기존 Codex hook은 보존·백업합니다. 필요하면 셸 설정에 ~/.local/bin PATH를 추가합니다. 다른 에이전트의 로그인 정보는 복사하지 않습니다. 설치 후 AI 세션을 새로 시작하세요.
아래 링크는 설치 명령을 실행하지 않고 압축 파일만 받습니다. 압축을 푼 뒤 bin/의 실행 파일을 원하는 경로에 직접 배치하세요.
배포 버전: preview-20261008.3. 앱의 버전 번호가 같아도 배포 날짜와 빌드는 달라질 수 있습니다.
KEEP GOING
업데이트부터 계정 연결까지,
필요할 때 다시 찾아보세요.
설치할 도구를 선택하고 같은 설치 명령을 다시 실행하세요. 선택하지 않은 도구의 기존 설치는 유지됩니다.
실행 중인 gdmux 세션은 기존 백그라운드 프로그램을 계속 사용합니다. 작업을 마친 뒤 모든 세션을 닫고 gdmux를 새로 시작하면 새 버전이 적용됩니다. 설치기가 실행 중인 작업을 종료하지는 않습니다.
설치 명령으로 이동기기 언어가 한국어이면 한국어로, 그 외에는 영어로 시작합니다. 직접 선택한 언어는 저장됩니다. 화면 언어만 바꾸며, 터미널 출력·파일·대화 내용과 AI 답변 언어는 바꾸지 않습니다.
iPhone 앱의 전체 영어 지원과 앱 내 언어 선택은 다음 업데이트에 포함될 예정입니다. 현재 App Store 버전은 일부 화면만 영어를 지원합니다.
소개 페이지는 위쪽 지구본 아이콘의 언어 메뉴에서 전환합니다. 공유한 /en/ 주소는 항상 영어로 열리며, 도구 선택과 현재 위치도 유지합니다.
gdmux: Ctrl+B 다음 p로 명령 팔레트를 열고 language 또는 언어를 검색하세요. Language: English / Language: 한국어 / Language: Auto / 자동에서 고릅니다. 선택은 바로 적용되고 개인 설정에 저장됩니다.
gid: 대화에서 /language en 또는 /language ko를 입력하면 개인 기본값으로 저장합니다. /language auto는 고정 선택을 해제하고 기기 언어를 따릅니다.
gdm: gdm language en 또는 gdm language ko로 기본값을 저장합니다. gdm language auto로 자동 선택에 돌아갑니다. 이번 실행에만 적용하려면 아래처럼 실행하세요.
gdmux --language en
gid --language en
gdm --language en --helpgid의 기본 엔진은 공식 Codex·Claude CLI에서 모델 목록을 자동으로 조회합니다. /model을 열거나 r을 누르면 갱신하고, 목록 화면을 열어 두면 15분마다 다시 확인합니다.
새 모델을 목록에 추가하기 위해 매번 gid를 다시 설치할 필요는 없습니다. 다만 공식 CLI가 새 모델을 제공해야 하므로, 목록이 오래됐다면 해당 CLI도 업데이트하세요. 목록에 표시되더라도 실제 사용 가능 여부는 계정과 서비스의 응답에 따라 달라집니다.
조회 실패 시 마지막 정상 목록을 유지하며, 저장된 목록도 없으면 기본 모델 별칭을 표시합니다. 새 모델이 나타나도 현재 선택과 기본값은 자동으로 바뀌지 않습니다. 원하는 모델을 고른 뒤 s 또는 /model save로 기본값을 저장하세요.
네. gdmux와 gid는 각 사용자의 홈 폴더에 있는 설정을 읽습니다. 처음 설치하면 Tokyo Night로 시작하며, 이미 선택한 테마는 유지됩니다. 아래는 기본 설정 경로 기준입니다. 설정 파일을 먼저 백업하고, 기존 항목을 남긴 채 필요한 값만 합치세요.
선택형 스킨 예시: Black Glass. 아래 파일은 개인 취향에 맞게 색상을 바꾸는 예시입니다. 소개 화면은 기본 테마를 사용하며, 이 스킨은 원하는 경우에만 적용하세요.
gid: ~/.config/gid/config.json의 ui.theme에서 테마를 선택합니다. 아래는 해당 항목만 보여주는 예시입니다.
{
"ui": { "theme": "black-glass" }
}gid용 Black Glass JSON 받기 ↓ · 받은 파일을 ~/.config/gid/themes/black-glass.json에 저장하세요. 파일을 둔 뒤 대화에서 /theme black-glass로 선택할 수도 있습니다. 프로젝트의 .gid/settings.json에 테마가 있으면 개인 설정보다 우선합니다.
gdmux: ~/.config/gdmux/config.toml에서 [theme]와 [theme.colors]를 바꿉니다. gdmux용 Black Glass TOML 받기 ↓의 두 테마 섹션을 기존 파일에 합치세요. 같은 섹션을 중복으로 추가하거나 파일 전체를 덮어쓰지 마세요. 다음에 gdmux 화면을 열 때 적용됩니다.
반투명 배경: Black Glass의 바탕은 터미널 배경을 따릅니다. Ghostty에서 검정 배경과 투명도를 설정하면 바탕이 비치며, 글자를 읽는 패널은 어두운 불투명 색상을 유지합니다. 아래 값은 Ghostty 설정 예시이며 스킨 파일만으로 터미널 설정이 바뀌지는 않습니다.
background = 000000
background-opacity = 0.7
background-blur = true터미널이 투명 배경을 지원해야 하며 macOS의 네이티브 전체 화면에서는 불투명하게 보일 수 있습니다. gdmux를 --theme 또는 GDMUX_THEME로 실행하면 파일의 사용자 색상 대신 지정한 기본 테마가 적용됩니다.
기본 경로 기준으로, 제거할 도구의 실행 파일만 직접 삭제하세요. 아래 명령은 안내용이며 이 페이지에서 실행되지 않습니다.
gdmux와 함께 설치되는 실행 파일 4개:
rm ~/.local/bin/gdmux ~/.local/bin/gdmuxd ~/.local/bin/gdmuxctl ~/.local/bin/gdmux-remotegid와 gdm을 모두 제거할 때:
rm ~/.local/bin/gid ~/.local/bin/gdm둘 중 하나만 제거하려면 해당 실행 파일 경로만 남기세요. 다른 경로에 설치했다면 실제 설치 경로를 사용하세요.
작업·대화·계정 설정과 별도로 설치한 gdm 스킬은 남습니다. 스킬까지 제거하려면 에이전트 설정의 gdm hook을 먼저 해제하고 각 에이전트의 gdm-* 스킬을 삭제하세요. 다른 hook은 유지하세요.
gid의 AI 기능에는 공식 Codex 또는 Claude CLI와 해당 서비스 로그인이 필요합니다. gid auth status로 상태를 확인하고, 사용할 서비스에 따라 gid login codex 또는 gid login claude를 실행하세요.
이 설치에는 AI 서비스 이용권이 포함되지 않습니다. 로그인되지 않는다면 해당 공식 CLI의 로그인 상태도 확인하세요.
gid 첫 실행 안내macOS 13 이상에서 Apple Silicon과 Intel을 지원하는 공개 프리뷰입니다. 공개 실행 파일은 Developer ID 서명과 Apple 공증을 마쳤습니다. Rust·Bun 설치나 GitHub 로그인 없이 설치할 수 있습니다.
소스 저장소는 현재 private입니다. Windows·Linux용 공개 설치 파일은 아직 제공하지 않습니다.
iOS 17 이상에서 App Store의 gdmux 앱을 무료로 다운로드하세요. 원격 작업에는 켜져 있고 네트워크에 연결된 Mac과 연결 프로그램이 필요합니다.
Mac에서 아래 명령을 실행하고 안내에 따라 계정과 Mac을 연결합니다. iPhone 앱에서도 같은 계정을 사용하세요. gdmux 안에서는 Ctrl+B 다음 m으로 연결 설정을 열 수 있습니다.
gdmux --remoteiPhone에서 새 gid 작업을 만들려면 gid를 별도로 설치하거나 모두 설치를 선택하세요. 현재 Mac의 ~/.local/bin/gid를 사용하므로 기본 경로에 설치해야 합니다.
START ON YOUR MAC
필요한 도구를 고르고, Mac 터미널에서 두 줄을 실행하세요.
계정 연결과 첫 실행은 선택한 도구에 맞춰 안내합니다.
INSTALL / MACOS
셋을 함께 써도, 하나부터 시작해도 좋습니다.
설치할 도구를 고르면 명령이 바뀝니다.
macOS 13 이상 Apple Silicon / Intel 공개 프리뷰
2026.10.08 업데이트 · 모델 목록 자동 조회 · 실행 안정성 개선 · 개인별 테마 설정
코딩 대화를 위한 gid 실행 파일 1개를 설치합니다.
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh --tool gid좌우로 스크롤하면 두 명령의 전체 내용을 볼 수 있습니다.
위의 두 줄을 Mac 터미널에 붙여넣으세요. 관리자 암호나 GitHub 로그인은 필요 없습니다.
gidgdm 스킬은 모두 설치 또는 gdm을 선택할 때 추가할 수 있습니다.
AFTER INSTALL / FIRST RUN
Mac에서 설치 명령을 실행한 뒤
선택한 도구의 안내를 따라가세요.
준비할 것: 공식 Codex 또는 Claude CLI와 해당 서비스 계정. 먼저 공식 CLI를 설치하세요.
gid auth status아래에서 사용할 서비스의 명령 하나를 실행하세요.
gid login codex
# 또는
gid login claudemy-project를 실제 프로젝트 폴더로 바꾸세요. 이미 그 폴더에 있다면 gid만 실행해도 됩니다.
gid --cwd ~/projects/my-projectClaude를 사용한다면:
gid --provider claude --cwd ~/projects/my-project설치만으로 AI 계정이 생성되거나 로그인되지는 않습니다. gdmux 안에서는 Ctrl+B 다음 a로 gid를 선택할 수 있습니다.
기본 설치 경로는 ~/.local/bin입니다. 설치 후 새 터미널을 열고 선택한 도구를 실행하세요.
command not found가 나오면 셸 설정 파일(기본 zsh는 ~/.zshrc)에 아래 줄을 추가하고 새 터미널을 여세요. PATH는 터미널이 실행 파일을 찾는 경로입니다.
export PATH="$HOME/.local/bin:$PATH"다른 경로는 설치 명령에 --prefix /절대/경로를 추가해 지정할 수 있습니다. iPhone에서 새 gid 작업을 만들려면 gid는 기본 경로에 설치하세요. 현재 ~/.local/bin/gid를 찾습니다.
기본 설치는 실행 파일과 라이선스 안내만 설치합니다. 셸 시작 파일이나 AI 에이전트 설정은 바꾸지 않습니다.
스킬을 선택하면 Codex·Claude·Pi용 gdm 스킬, gdm-pi 실행기와 Codex 작업 게이트를 추가합니다. 작업 게이트는 AI 작업이 끝날 때 검증 결과를 확인하는 hook입니다.
기존 gdm 스킬을 업데이트하고, 기존 Codex hook은 보존·백업합니다. 필요하면 셸 설정에 ~/.local/bin PATH를 추가합니다. 다른 에이전트의 로그인 정보는 복사하지 않습니다. 설치 후 AI 세션을 새로 시작하세요.
아래 링크는 설치 명령을 실행하지 않고 압축 파일만 받습니다. 압축을 푼 뒤 bin/의 실행 파일을 원하는 경로에 직접 배치하세요.
배포 버전: preview-20261008.3. 앱의 버전 번호가 같아도 배포 날짜와 빌드는 달라질 수 있습니다.
KEEP GOING
업데이트부터 계정 연결까지,
필요할 때 다시 찾아보세요.
설치할 도구를 선택하고 같은 설치 명령을 다시 실행하세요. 선택하지 않은 도구의 기존 설치는 유지됩니다.
실행 중인 gdmux 세션은 기존 백그라운드 프로그램을 계속 사용합니다. 작업을 마친 뒤 모든 세션을 닫고 gdmux를 새로 시작하면 새 버전이 적용됩니다. 설치기가 실행 중인 작업을 종료하지는 않습니다.
설치 명령으로 이동기기 언어가 한국어이면 한국어로, 그 외에는 영어로 시작합니다. 직접 선택한 언어는 저장됩니다. 화면 언어만 바꾸며, 터미널 출력·파일·대화 내용과 AI 답변 언어는 바꾸지 않습니다.
iPhone 앱의 전체 영어 지원과 앱 내 언어 선택은 다음 업데이트에 포함될 예정입니다. 현재 App Store 버전은 일부 화면만 영어를 지원합니다.
소개 페이지는 위쪽 지구본 아이콘의 언어 메뉴에서 전환합니다. 공유한 /en/ 주소는 항상 영어로 열리며, 도구 선택과 현재 위치도 유지합니다.
gdmux: Ctrl+B 다음 p로 명령 팔레트를 열고 language 또는 언어를 검색하세요. Language: English / Language: 한국어 / Language: Auto / 자동에서 고릅니다. 선택은 바로 적용되고 개인 설정에 저장됩니다.
gid: 대화에서 /language en 또는 /language ko를 입력하면 개인 기본값으로 저장합니다. /language auto는 고정 선택을 해제하고 기기 언어를 따릅니다.
gdm: gdm language en 또는 gdm language ko로 기본값을 저장합니다. gdm language auto로 자동 선택에 돌아갑니다. 이번 실행에만 적용하려면 아래처럼 실행하세요.
gdmux --language en
gid --language en
gdm --language en --helpgid의 기본 엔진은 공식 Codex·Claude CLI에서 모델 목록을 자동으로 조회합니다. /model을 열거나 r을 누르면 갱신하고, 목록 화면을 열어 두면 15분마다 다시 확인합니다.
새 모델을 목록에 추가하기 위해 매번 gid를 다시 설치할 필요는 없습니다. 다만 공식 CLI가 새 모델을 제공해야 하므로, 목록이 오래됐다면 해당 CLI도 업데이트하세요. 목록에 표시되더라도 실제 사용 가능 여부는 계정과 서비스의 응답에 따라 달라집니다.
조회 실패 시 마지막 정상 목록을 유지하며, 저장된 목록도 없으면 기본 모델 별칭을 표시합니다. 새 모델이 나타나도 현재 선택과 기본값은 자동으로 바뀌지 않습니다. 원하는 모델을 고른 뒤 s 또는 /model save로 기본값을 저장하세요.
네. gdmux와 gid는 각 사용자의 홈 폴더에 있는 설정을 읽습니다. 처음 설치하면 Tokyo Night로 시작하며, 이미 선택한 테마는 유지됩니다. 아래는 기본 설정 경로 기준입니다. 설정 파일을 먼저 백업하고, 기존 항목을 남긴 채 필요한 값만 합치세요.
선택형 스킨 예시: Black Glass. 아래 파일은 개인 취향에 맞게 색상을 바꾸는 예시입니다. 소개 화면은 기본 테마를 사용하며, 이 스킨은 원하는 경우에만 적용하세요.
gid: ~/.config/gid/config.json의 ui.theme에서 테마를 선택합니다. 아래는 해당 항목만 보여주는 예시입니다.
{
"ui": { "theme": "black-glass" }
}gid용 Black Glass JSON 받기 ↓ · 받은 파일을 ~/.config/gid/themes/black-glass.json에 저장하세요. 파일을 둔 뒤 대화에서 /theme black-glass로 선택할 수도 있습니다. 프로젝트의 .gid/settings.json에 테마가 있으면 개인 설정보다 우선합니다.
gdmux: ~/.config/gdmux/config.toml에서 [theme]와 [theme.colors]를 바꿉니다. gdmux용 Black Glass TOML 받기 ↓의 두 테마 섹션을 기존 파일에 합치세요. 같은 섹션을 중복으로 추가하거나 파일 전체를 덮어쓰지 마세요. 다음에 gdmux 화면을 열 때 적용됩니다.
반투명 배경: Black Glass의 바탕은 터미널 배경을 따릅니다. Ghostty에서 검정 배경과 투명도를 설정하면 바탕이 비치며, 글자를 읽는 패널은 어두운 불투명 색상을 유지합니다. 아래 값은 Ghostty 설정 예시이며 스킨 파일만으로 터미널 설정이 바뀌지는 않습니다.
background = 000000
background-opacity = 0.7
background-blur = true터미널이 투명 배경을 지원해야 하며 macOS의 네이티브 전체 화면에서는 불투명하게 보일 수 있습니다. gdmux를 --theme 또는 GDMUX_THEME로 실행하면 파일의 사용자 색상 대신 지정한 기본 테마가 적용됩니다.
기본 경로 기준으로, 제거할 도구의 실행 파일만 직접 삭제하세요. 아래 명령은 안내용이며 이 페이지에서 실행되지 않습니다.
gdmux와 함께 설치되는 실행 파일 4개:
rm ~/.local/bin/gdmux ~/.local/bin/gdmuxd ~/.local/bin/gdmuxctl ~/.local/bin/gdmux-remotegid와 gdm을 모두 제거할 때:
rm ~/.local/bin/gid ~/.local/bin/gdm둘 중 하나만 제거하려면 해당 실행 파일 경로만 남기세요. 다른 경로에 설치했다면 실제 설치 경로를 사용하세요.
작업·대화·계정 설정과 별도로 설치한 gdm 스킬은 남습니다. 스킬까지 제거하려면 에이전트 설정의 gdm hook을 먼저 해제하고 각 에이전트의 gdm-* 스킬을 삭제하세요. 다른 hook은 유지하세요.
gid의 AI 기능에는 공식 Codex 또는 Claude CLI와 해당 서비스 로그인이 필요합니다. gid auth status로 상태를 확인하고, 사용할 서비스에 따라 gid login codex 또는 gid login claude를 실행하세요.
이 설치에는 AI 서비스 이용권이 포함되지 않습니다. 로그인되지 않는다면 해당 공식 CLI의 로그인 상태도 확인하세요.
gid 첫 실행 안내macOS 13 이상에서 Apple Silicon과 Intel을 지원하는 공개 프리뷰입니다. 공개 실행 파일은 Developer ID 서명과 Apple 공증을 마쳤습니다. Rust·Bun 설치나 GitHub 로그인 없이 설치할 수 있습니다.
소스 저장소는 현재 private입니다. Windows·Linux용 공개 설치 파일은 아직 제공하지 않습니다.
iOS 17 이상에서 App Store의 gdmux 앱을 무료로 다운로드하세요. 원격 작업에는 켜져 있고 네트워크에 연결된 Mac과 연결 프로그램이 필요합니다.
Mac에서 아래 명령을 실행하고 안내에 따라 계정과 Mac을 연결합니다. iPhone 앱에서도 같은 계정을 사용하세요. gdmux 안에서는 Ctrl+B 다음 m으로 연결 설정을 열 수 있습니다.
gdmux --remoteiPhone에서 새 gid 작업을 만들려면 gid를 별도로 설치하거나 모두 설치를 선택하세요. 현재 Mac의 ~/.local/bin/gid를 사용하므로 기본 경로에 설치해야 합니다.
START ON YOUR MAC
필요한 도구를 고르고, Mac 터미널에서 두 줄을 실행하세요.
계정 연결과 첫 실행은 선택한 도구에 맞춰 안내합니다.
INSTALL / MACOS
셋을 함께 써도, 하나부터 시작해도 좋습니다.
설치할 도구를 고르면 명령이 바뀝니다.
macOS 13 이상 Apple Silicon / Intel 공개 프리뷰
2026.10.08 업데이트 · 모델 목록 자동 조회 · 실행 안정성 개선 · 개인별 테마 설정
작업 검증을 위한 gdm 실행 파일 1개를 설치합니다.
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh --tool gdm좌우로 스크롤하면 두 명령의 전체 내용을 볼 수 있습니다.
위의 두 줄을 Mac 터미널에 붙여넣으세요. 관리자 암호나 GitHub 로그인은 필요 없습니다.
gdmAFTER INSTALL / FIRST RUN
Mac에서 설치 명령을 실행한 뒤
선택한 도구의 안내를 따라가세요.
준비할 것: CLI로 직접 쓰려면 작업할 프로젝트. AI에게 작업을 요청하려면 별도로 Codex 또는 Claude와 gdm 스킬이 필요합니다.
gdm --help
gdm doctor원한다면 gdm 스킬을 추가해 AI에게 작업을 요청할 수 있습니다. CLI로 직접 사용하려면 gdm --help에서 명령을 확인하세요.
스킬을 설치했다면 프로젝트에서 Codex 또는 Claude 세션을 새로 시작하세요.
Codex에서:
$gdm-go 로그인 오류를 수정하고 검증까지 완료해줘Claude Code에서:
/gdm-go 로그인 오류를 수정하고 검증까지 완료해줘스킬을 Pi에서 사용하려면 Pi를 별도로 설치한 뒤 gdm-pi로 시작하세요. AI에게 일상 작업을 요청할 때는 gdm-go부터 사용할 수 있습니다.
기본 설치 경로는 ~/.local/bin입니다. 설치 후 새 터미널을 열고 선택한 도구를 실행하세요.
command not found가 나오면 셸 설정 파일(기본 zsh는 ~/.zshrc)에 아래 줄을 추가하고 새 터미널을 여세요. PATH는 터미널이 실행 파일을 찾는 경로입니다.
export PATH="$HOME/.local/bin:$PATH"다른 경로는 설치 명령에 --prefix /절대/경로를 추가해 지정할 수 있습니다. iPhone에서 새 gid 작업을 만들려면 gid는 기본 경로에 설치하세요. 현재 ~/.local/bin/gid를 찾습니다.
기본 설치는 실행 파일과 라이선스 안내만 설치합니다. 셸 시작 파일이나 AI 에이전트 설정은 바꾸지 않습니다.
스킬을 선택하면 Codex·Claude·Pi용 gdm 스킬, gdm-pi 실행기와 Codex 작업 게이트를 추가합니다. 작업 게이트는 AI 작업이 끝날 때 검증 결과를 확인하는 hook입니다.
기존 gdm 스킬을 업데이트하고, 기존 Codex hook은 보존·백업합니다. 필요하면 셸 설정에 ~/.local/bin PATH를 추가합니다. 다른 에이전트의 로그인 정보는 복사하지 않습니다. 설치 후 AI 세션을 새로 시작하세요.
아래 링크는 설치 명령을 실행하지 않고 압축 파일만 받습니다. 압축을 푼 뒤 bin/의 실행 파일을 원하는 경로에 직접 배치하세요.
배포 버전: preview-20261008.3. 앱의 버전 번호가 같아도 배포 날짜와 빌드는 달라질 수 있습니다.
KEEP GOING
업데이트부터 계정 연결까지,
필요할 때 다시 찾아보세요.
설치할 도구를 선택하고 같은 설치 명령을 다시 실행하세요. 선택하지 않은 도구의 기존 설치는 유지됩니다.
실행 중인 gdmux 세션은 기존 백그라운드 프로그램을 계속 사용합니다. 작업을 마친 뒤 모든 세션을 닫고 gdmux를 새로 시작하면 새 버전이 적용됩니다. 설치기가 실행 중인 작업을 종료하지는 않습니다.
설치 명령으로 이동기기 언어가 한국어이면 한국어로, 그 외에는 영어로 시작합니다. 직접 선택한 언어는 저장됩니다. 화면 언어만 바꾸며, 터미널 출력·파일·대화 내용과 AI 답변 언어는 바꾸지 않습니다.
iPhone 앱의 전체 영어 지원과 앱 내 언어 선택은 다음 업데이트에 포함될 예정입니다. 현재 App Store 버전은 일부 화면만 영어를 지원합니다.
소개 페이지는 위쪽 지구본 아이콘의 언어 메뉴에서 전환합니다. 공유한 /en/ 주소는 항상 영어로 열리며, 도구 선택과 현재 위치도 유지합니다.
gdmux: Ctrl+B 다음 p로 명령 팔레트를 열고 language 또는 언어를 검색하세요. Language: English / Language: 한국어 / Language: Auto / 자동에서 고릅니다. 선택은 바로 적용되고 개인 설정에 저장됩니다.
gid: 대화에서 /language en 또는 /language ko를 입력하면 개인 기본값으로 저장합니다. /language auto는 고정 선택을 해제하고 기기 언어를 따릅니다.
gdm: gdm language en 또는 gdm language ko로 기본값을 저장합니다. gdm language auto로 자동 선택에 돌아갑니다. 이번 실행에만 적용하려면 아래처럼 실행하세요.
gdmux --language en
gid --language en
gdm --language en --helpgid의 기본 엔진은 공식 Codex·Claude CLI에서 모델 목록을 자동으로 조회합니다. /model을 열거나 r을 누르면 갱신하고, 목록 화면을 열어 두면 15분마다 다시 확인합니다.
새 모델을 목록에 추가하기 위해 매번 gid를 다시 설치할 필요는 없습니다. 다만 공식 CLI가 새 모델을 제공해야 하므로, 목록이 오래됐다면 해당 CLI도 업데이트하세요. 목록에 표시되더라도 실제 사용 가능 여부는 계정과 서비스의 응답에 따라 달라집니다.
조회 실패 시 마지막 정상 목록을 유지하며, 저장된 목록도 없으면 기본 모델 별칭을 표시합니다. 새 모델이 나타나도 현재 선택과 기본값은 자동으로 바뀌지 않습니다. 원하는 모델을 고른 뒤 s 또는 /model save로 기본값을 저장하세요.
네. gdmux와 gid는 각 사용자의 홈 폴더에 있는 설정을 읽습니다. 처음 설치하면 Tokyo Night로 시작하며, 이미 선택한 테마는 유지됩니다. 아래는 기본 설정 경로 기준입니다. 설정 파일을 먼저 백업하고, 기존 항목을 남긴 채 필요한 값만 합치세요.
선택형 스킨 예시: Black Glass. 아래 파일은 개인 취향에 맞게 색상을 바꾸는 예시입니다. 소개 화면은 기본 테마를 사용하며, 이 스킨은 원하는 경우에만 적용하세요.
gid: ~/.config/gid/config.json의 ui.theme에서 테마를 선택합니다. 아래는 해당 항목만 보여주는 예시입니다.
{
"ui": { "theme": "black-glass" }
}gid용 Black Glass JSON 받기 ↓ · 받은 파일을 ~/.config/gid/themes/black-glass.json에 저장하세요. 파일을 둔 뒤 대화에서 /theme black-glass로 선택할 수도 있습니다. 프로젝트의 .gid/settings.json에 테마가 있으면 개인 설정보다 우선합니다.
gdmux: ~/.config/gdmux/config.toml에서 [theme]와 [theme.colors]를 바꿉니다. gdmux용 Black Glass TOML 받기 ↓의 두 테마 섹션을 기존 파일에 합치세요. 같은 섹션을 중복으로 추가하거나 파일 전체를 덮어쓰지 마세요. 다음에 gdmux 화면을 열 때 적용됩니다.
반투명 배경: Black Glass의 바탕은 터미널 배경을 따릅니다. Ghostty에서 검정 배경과 투명도를 설정하면 바탕이 비치며, 글자를 읽는 패널은 어두운 불투명 색상을 유지합니다. 아래 값은 Ghostty 설정 예시이며 스킨 파일만으로 터미널 설정이 바뀌지는 않습니다.
background = 000000
background-opacity = 0.7
background-blur = true터미널이 투명 배경을 지원해야 하며 macOS의 네이티브 전체 화면에서는 불투명하게 보일 수 있습니다. gdmux를 --theme 또는 GDMUX_THEME로 실행하면 파일의 사용자 색상 대신 지정한 기본 테마가 적용됩니다.
기본 경로 기준으로, 제거할 도구의 실행 파일만 직접 삭제하세요. 아래 명령은 안내용이며 이 페이지에서 실행되지 않습니다.
gdmux와 함께 설치되는 실행 파일 4개:
rm ~/.local/bin/gdmux ~/.local/bin/gdmuxd ~/.local/bin/gdmuxctl ~/.local/bin/gdmux-remotegid와 gdm을 모두 제거할 때:
rm ~/.local/bin/gid ~/.local/bin/gdm둘 중 하나만 제거하려면 해당 실행 파일 경로만 남기세요. 다른 경로에 설치했다면 실제 설치 경로를 사용하세요.
작업·대화·계정 설정과 별도로 설치한 gdm 스킬은 남습니다. 스킬까지 제거하려면 에이전트 설정의 gdm hook을 먼저 해제하고 각 에이전트의 gdm-* 스킬을 삭제하세요. 다른 hook은 유지하세요.
gid의 AI 기능에는 공식 Codex 또는 Claude CLI와 해당 서비스 로그인이 필요합니다. gid auth status로 상태를 확인하고, 사용할 서비스에 따라 gid login codex 또는 gid login claude를 실행하세요.
이 설치에는 AI 서비스 이용권이 포함되지 않습니다. 로그인되지 않는다면 해당 공식 CLI의 로그인 상태도 확인하세요.
gid 첫 실행 안내macOS 13 이상에서 Apple Silicon과 Intel을 지원하는 공개 프리뷰입니다. 공개 실행 파일은 Developer ID 서명과 Apple 공증을 마쳤습니다. Rust·Bun 설치나 GitHub 로그인 없이 설치할 수 있습니다.
소스 저장소는 현재 private입니다. Windows·Linux용 공개 설치 파일은 아직 제공하지 않습니다.
iOS 17 이상에서 App Store의 gdmux 앱을 무료로 다운로드하세요. 원격 작업에는 켜져 있고 네트워크에 연결된 Mac과 연결 프로그램이 필요합니다.
Mac에서 아래 명령을 실행하고 안내에 따라 계정과 Mac을 연결합니다. iPhone 앱에서도 같은 계정을 사용하세요. gdmux 안에서는 Ctrl+B 다음 m으로 연결 설정을 열 수 있습니다.
gdmux --remoteiPhone에서 새 gid 작업을 만들려면 gid를 별도로 설치하거나 모두 설치를 선택하세요. 현재 Mac의 ~/.local/bin/gid를 사용하므로 기본 경로에 설치해야 합니다.
START ON YOUR MAC
필요한 도구를 고르고, Mac 터미널에서 두 줄을 실행하세요.
계정 연결과 첫 실행은 선택한 도구에 맞춰 안내합니다.
INSTALL / MACOS
셋을 함께 써도, 하나부터 시작해도 좋습니다.
설치할 도구를 고르면 명령이 바뀝니다.
macOS 13 이상 Apple Silicon / Intel 공개 프리뷰
2026.10.08 업데이트 · 모델 목록 자동 조회 · 실행 안정성 개선 · 개인별 테마 설정
세 도구의 실행 파일 6개를 함께 설치합니다.
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh --tool all --with-skills좌우로 스크롤하면 두 명령의 전체 내용을 볼 수 있습니다.
위의 두 줄을 Mac 터미널에 붙여넣으세요. 관리자 암호나 GitHub 로그인은 필요 없습니다.
gdmuxgdmuxdgdmuxctlgdmux-remotegidgdmAFTER INSTALL / FIRST RUN
Mac에서 설치 명령을 실행한 뒤
선택한 도구의 안내를 따라가세요.
준비할 것: Mac 터미널. 24비트 색상을 지원하는 최신 터미널을 권장합니다.
gdmuxCtrl+B를 누른 뒤 a로 새 작업을 실행하세요. Ctrl+B 다음 v 또는 s로 화면을 나눕니다.
Ctrl+B 다음 w는 전체 작업, ?는 단축키 도움말입니다.
모두 설치에는 gid가 포함됩니다. gdmux 안에서 gid를 실행하기 전, gid의 계정 연결 안내도 확인하세요.
준비할 것: 공식 Codex 또는 Claude CLI와 해당 서비스 계정. 먼저 공식 CLI를 설치하세요.
gid auth status아래에서 사용할 서비스의 명령 하나를 실행하세요.
gid login codex
# 또는
gid login claude작업할 프로젝트 폴더에서 사용할 서비스에 맞춰 실행하세요.
Codex:
gidClaude:
gid --provider claude설치만으로 AI 계정이 생성되거나 로그인되지는 않습니다. gdmux 안에서는 Ctrl+B 다음 a로 gid를 선택할 수 있습니다.
준비할 것: CLI로 직접 쓰려면 작업할 프로젝트. AI에게 작업을 요청하려면 별도로 Codex 또는 Claude와 gdm 스킬이 필요합니다.
gdm --help
gdm doctor위 설치 명령에 --with-skills가 포함되어 있습니다. AI에서 사용하려면 명령을 실행한 뒤 프로젝트에서 Codex 또는 Claude 세션을 새로 시작하세요.
Codex에서:
$gdm-go 로그인 오류를 수정하고 검증까지 완료해줘Claude Code에서:
/gdm-go 로그인 오류를 수정하고 검증까지 완료해줘스킬을 Pi에서 사용하려면 Pi를 별도로 설치한 뒤 gdm-pi로 시작하세요. AI에게 일상 작업을 요청할 때는 gdm-go부터 사용할 수 있습니다.
기본 설치 경로는 ~/.local/bin입니다. 설치 후 새 터미널을 열고 선택한 도구를 실행하세요.
command not found가 나오면 셸 설정 파일(기본 zsh는 ~/.zshrc)에 아래 줄을 추가하고 새 터미널을 여세요. PATH는 터미널이 실행 파일을 찾는 경로입니다.
export PATH="$HOME/.local/bin:$PATH"다른 경로는 설치 명령에 --prefix /절대/경로를 추가해 지정할 수 있습니다. iPhone에서 새 gid 작업을 만들려면 gid는 기본 경로에 설치하세요. 현재 ~/.local/bin/gid를 찾습니다.
기본 설치는 실행 파일과 라이선스 안내만 설치합니다. 셸 시작 파일이나 AI 에이전트 설정은 바꾸지 않습니다.
스킬을 선택하면 Codex·Claude·Pi용 gdm 스킬, gdm-pi 실행기와 Codex 작업 게이트를 추가합니다. 작업 게이트는 AI 작업이 끝날 때 검증 결과를 확인하는 hook입니다.
기존 gdm 스킬을 업데이트하고, 기존 Codex hook은 보존·백업합니다. 필요하면 셸 설정에 ~/.local/bin PATH를 추가합니다. 다른 에이전트의 로그인 정보는 복사하지 않습니다. 설치 후 AI 세션을 새로 시작하세요.
아래 링크는 설치 명령을 실행하지 않고 압축 파일만 받습니다. 압축을 푼 뒤 bin/의 실행 파일을 원하는 경로에 직접 배치하세요.
배포 버전: preview-20261008.3. 앱의 버전 번호가 같아도 배포 날짜와 빌드는 달라질 수 있습니다.
KEEP GOING
업데이트부터 계정 연결까지,
필요할 때 다시 찾아보세요.
설치할 도구를 선택하고 같은 설치 명령을 다시 실행하세요. 선택하지 않은 도구의 기존 설치는 유지됩니다.
실행 중인 gdmux 세션은 기존 백그라운드 프로그램을 계속 사용합니다. 작업을 마친 뒤 모든 세션을 닫고 gdmux를 새로 시작하면 새 버전이 적용됩니다. 설치기가 실행 중인 작업을 종료하지는 않습니다.
설치 명령으로 이동기기 언어가 한국어이면 한국어로, 그 외에는 영어로 시작합니다. 직접 선택한 언어는 저장됩니다. 화면 언어만 바꾸며, 터미널 출력·파일·대화 내용과 AI 답변 언어는 바꾸지 않습니다.
iPhone 앱의 전체 영어 지원과 앱 내 언어 선택은 다음 업데이트에 포함될 예정입니다. 현재 App Store 버전은 일부 화면만 영어를 지원합니다.
소개 페이지는 위쪽 지구본 아이콘의 언어 메뉴에서 전환합니다. 공유한 /en/ 주소는 항상 영어로 열리며, 도구 선택과 현재 위치도 유지합니다.
gdmux: Ctrl+B 다음 p로 명령 팔레트를 열고 language 또는 언어를 검색하세요. Language: English / Language: 한국어 / Language: Auto / 자동에서 고릅니다. 선택은 바로 적용되고 개인 설정에 저장됩니다.
gid: 대화에서 /language en 또는 /language ko를 입력하면 개인 기본값으로 저장합니다. /language auto는 고정 선택을 해제하고 기기 언어를 따릅니다.
gdm: gdm language en 또는 gdm language ko로 기본값을 저장합니다. gdm language auto로 자동 선택에 돌아갑니다. 이번 실행에만 적용하려면 아래처럼 실행하세요.
gdmux --language en
gid --language en
gdm --language en --helpgid의 기본 엔진은 공식 Codex·Claude CLI에서 모델 목록을 자동으로 조회합니다. /model을 열거나 r을 누르면 갱신하고, 목록 화면을 열어 두면 15분마다 다시 확인합니다.
새 모델을 목록에 추가하기 위해 매번 gid를 다시 설치할 필요는 없습니다. 다만 공식 CLI가 새 모델을 제공해야 하므로, 목록이 오래됐다면 해당 CLI도 업데이트하세요. 목록에 표시되더라도 실제 사용 가능 여부는 계정과 서비스의 응답에 따라 달라집니다.
조회 실패 시 마지막 정상 목록을 유지하며, 저장된 목록도 없으면 기본 모델 별칭을 표시합니다. 새 모델이 나타나도 현재 선택과 기본값은 자동으로 바뀌지 않습니다. 원하는 모델을 고른 뒤 s 또는 /model save로 기본값을 저장하세요.
네. gdmux와 gid는 각 사용자의 홈 폴더에 있는 설정을 읽습니다. 처음 설치하면 Tokyo Night로 시작하며, 이미 선택한 테마는 유지됩니다. 아래는 기본 설정 경로 기준입니다. 설정 파일을 먼저 백업하고, 기존 항목을 남긴 채 필요한 값만 합치세요.
선택형 스킨 예시: Black Glass. 아래 파일은 개인 취향에 맞게 색상을 바꾸는 예시입니다. 소개 화면은 기본 테마를 사용하며, 이 스킨은 원하는 경우에만 적용하세요.
gid: ~/.config/gid/config.json의 ui.theme에서 테마를 선택합니다. 아래는 해당 항목만 보여주는 예시입니다.
{
"ui": { "theme": "black-glass" }
}gid용 Black Glass JSON 받기 ↓ · 받은 파일을 ~/.config/gid/themes/black-glass.json에 저장하세요. 파일을 둔 뒤 대화에서 /theme black-glass로 선택할 수도 있습니다. 프로젝트의 .gid/settings.json에 테마가 있으면 개인 설정보다 우선합니다.
gdmux: ~/.config/gdmux/config.toml에서 [theme]와 [theme.colors]를 바꿉니다. gdmux용 Black Glass TOML 받기 ↓의 두 테마 섹션을 기존 파일에 합치세요. 같은 섹션을 중복으로 추가하거나 파일 전체를 덮어쓰지 마세요. 다음에 gdmux 화면을 열 때 적용됩니다.
반투명 배경: Black Glass의 바탕은 터미널 배경을 따릅니다. Ghostty에서 검정 배경과 투명도를 설정하면 바탕이 비치며, 글자를 읽는 패널은 어두운 불투명 색상을 유지합니다. 아래 값은 Ghostty 설정 예시이며 스킨 파일만으로 터미널 설정이 바뀌지는 않습니다.
background = 000000
background-opacity = 0.7
background-blur = true터미널이 투명 배경을 지원해야 하며 macOS의 네이티브 전체 화면에서는 불투명하게 보일 수 있습니다. gdmux를 --theme 또는 GDMUX_THEME로 실행하면 파일의 사용자 색상 대신 지정한 기본 테마가 적용됩니다.
기본 경로 기준으로, 제거할 도구의 실행 파일만 직접 삭제하세요. 아래 명령은 안내용이며 이 페이지에서 실행되지 않습니다.
gdmux와 함께 설치되는 실행 파일 4개:
rm ~/.local/bin/gdmux ~/.local/bin/gdmuxd ~/.local/bin/gdmuxctl ~/.local/bin/gdmux-remotegid와 gdm을 모두 제거할 때:
rm ~/.local/bin/gid ~/.local/bin/gdm둘 중 하나만 제거하려면 해당 실행 파일 경로만 남기세요. 다른 경로에 설치했다면 실제 설치 경로를 사용하세요.
작업·대화·계정 설정과 별도로 설치한 gdm 스킬은 남습니다. 스킬까지 제거하려면 에이전트 설정의 gdm hook을 먼저 해제하고 각 에이전트의 gdm-* 스킬을 삭제하세요. 다른 hook은 유지하세요.
gid의 AI 기능에는 공식 Codex 또는 Claude CLI와 해당 서비스 로그인이 필요합니다. gid auth status로 상태를 확인하고, 사용할 서비스에 따라 gid login codex 또는 gid login claude를 실행하세요.
이 설치에는 AI 서비스 이용권이 포함되지 않습니다. 로그인되지 않는다면 해당 공식 CLI의 로그인 상태도 확인하세요.
gid 첫 실행 안내macOS 13 이상에서 Apple Silicon과 Intel을 지원하는 공개 프리뷰입니다. 공개 실행 파일은 Developer ID 서명과 Apple 공증을 마쳤습니다. Rust·Bun 설치나 GitHub 로그인 없이 설치할 수 있습니다.
소스 저장소는 현재 private입니다. Windows·Linux용 공개 설치 파일은 아직 제공하지 않습니다.
iOS 17 이상에서 App Store의 gdmux 앱을 무료로 다운로드하세요. 원격 작업에는 켜져 있고 네트워크에 연결된 Mac과 연결 프로그램이 필요합니다.
Mac에서 아래 명령을 실행하고 안내에 따라 계정과 Mac을 연결합니다. iPhone 앱에서도 같은 계정을 사용하세요. gdmux 안에서는 Ctrl+B 다음 m으로 연결 설정을 열 수 있습니다.
gdmux --remoteiPhone에서 새 gid 작업을 만들려면 gid를 별도로 설치하거나 모두 설치를 선택하세요. 현재 Mac의 ~/.local/bin/gid를 사용하므로 기본 경로에 설치해야 합니다.
START ON YOUR MAC
필요한 도구를 고르고, Mac 터미널에서 두 줄을 실행하세요.
계정 연결과 첫 실행은 선택한 도구에 맞춰 안내합니다.
INSTALL / MACOS
셋을 함께 써도, 하나부터 시작해도 좋습니다.
설치할 도구를 고르면 명령이 바뀝니다.
macOS 13 이상 Apple Silicon / Intel 공개 프리뷰
2026.10.08 업데이트 · 모델 목록 자동 조회 · 실행 안정성 개선 · 개인별 테마 설정
작업 검증을 위한 gdm 실행 파일 1개를 설치합니다.
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh --tool gdm --with-skills좌우로 스크롤하면 두 명령의 전체 내용을 볼 수 있습니다.
위의 두 줄을 Mac 터미널에 붙여넣으세요. 관리자 암호나 GitHub 로그인은 필요 없습니다.
gdmAFTER INSTALL / FIRST RUN
Mac에서 설치 명령을 실행한 뒤
선택한 도구의 안내를 따라가세요.
준비할 것: CLI로 직접 쓰려면 작업할 프로젝트. AI에게 작업을 요청하려면 별도로 Codex 또는 Claude와 gdm 스킬이 필요합니다.
gdm --help
gdm doctor위 설치 명령에 --with-skills가 포함되어 있습니다. AI에서 사용하려면 명령을 실행한 뒤 프로젝트에서 Codex 또는 Claude 세션을 새로 시작하세요.
Codex에서:
$gdm-go 로그인 오류를 수정하고 검증까지 완료해줘Claude Code에서:
/gdm-go 로그인 오류를 수정하고 검증까지 완료해줘스킬을 Pi에서 사용하려면 Pi를 별도로 설치한 뒤 gdm-pi로 시작하세요. AI에게 일상 작업을 요청할 때는 gdm-go부터 사용할 수 있습니다.
기본 설치 경로는 ~/.local/bin입니다. 설치 후 새 터미널을 열고 선택한 도구를 실행하세요.
command not found가 나오면 셸 설정 파일(기본 zsh는 ~/.zshrc)에 아래 줄을 추가하고 새 터미널을 여세요. PATH는 터미널이 실행 파일을 찾는 경로입니다.
export PATH="$HOME/.local/bin:$PATH"다른 경로는 설치 명령에 --prefix /절대/경로를 추가해 지정할 수 있습니다. iPhone에서 새 gid 작업을 만들려면 gid는 기본 경로에 설치하세요. 현재 ~/.local/bin/gid를 찾습니다.
기본 설치는 실행 파일과 라이선스 안내만 설치합니다. 셸 시작 파일이나 AI 에이전트 설정은 바꾸지 않습니다.
스킬을 선택하면 Codex·Claude·Pi용 gdm 스킬, gdm-pi 실행기와 Codex 작업 게이트를 추가합니다. 작업 게이트는 AI 작업이 끝날 때 검증 결과를 확인하는 hook입니다.
기존 gdm 스킬을 업데이트하고, 기존 Codex hook은 보존·백업합니다. 필요하면 셸 설정에 ~/.local/bin PATH를 추가합니다. 다른 에이전트의 로그인 정보는 복사하지 않습니다. 설치 후 AI 세션을 새로 시작하세요.
아래 링크는 설치 명령을 실행하지 않고 압축 파일만 받습니다. 압축을 푼 뒤 bin/의 실행 파일을 원하는 경로에 직접 배치하세요.
배포 버전: preview-20261008.3. 앱의 버전 번호가 같아도 배포 날짜와 빌드는 달라질 수 있습니다.
KEEP GOING
업데이트부터 계정 연결까지,
필요할 때 다시 찾아보세요.
설치할 도구를 선택하고 같은 설치 명령을 다시 실행하세요. 선택하지 않은 도구의 기존 설치는 유지됩니다.
실행 중인 gdmux 세션은 기존 백그라운드 프로그램을 계속 사용합니다. 작업을 마친 뒤 모든 세션을 닫고 gdmux를 새로 시작하면 새 버전이 적용됩니다. 설치기가 실행 중인 작업을 종료하지는 않습니다.
설치 명령으로 이동기기 언어가 한국어이면 한국어로, 그 외에는 영어로 시작합니다. 직접 선택한 언어는 저장됩니다. 화면 언어만 바꾸며, 터미널 출력·파일·대화 내용과 AI 답변 언어는 바꾸지 않습니다.
iPhone 앱의 전체 영어 지원과 앱 내 언어 선택은 다음 업데이트에 포함될 예정입니다. 현재 App Store 버전은 일부 화면만 영어를 지원합니다.
소개 페이지는 위쪽 지구본 아이콘의 언어 메뉴에서 전환합니다. 공유한 /en/ 주소는 항상 영어로 열리며, 도구 선택과 현재 위치도 유지합니다.
gdmux: Ctrl+B 다음 p로 명령 팔레트를 열고 language 또는 언어를 검색하세요. Language: English / Language: 한국어 / Language: Auto / 자동에서 고릅니다. 선택은 바로 적용되고 개인 설정에 저장됩니다.
gid: 대화에서 /language en 또는 /language ko를 입력하면 개인 기본값으로 저장합니다. /language auto는 고정 선택을 해제하고 기기 언어를 따릅니다.
gdm: gdm language en 또는 gdm language ko로 기본값을 저장합니다. gdm language auto로 자동 선택에 돌아갑니다. 이번 실행에만 적용하려면 아래처럼 실행하세요.
gdmux --language en
gid --language en
gdm --language en --helpgid의 기본 엔진은 공식 Codex·Claude CLI에서 모델 목록을 자동으로 조회합니다. /model을 열거나 r을 누르면 갱신하고, 목록 화면을 열어 두면 15분마다 다시 확인합니다.
새 모델을 목록에 추가하기 위해 매번 gid를 다시 설치할 필요는 없습니다. 다만 공식 CLI가 새 모델을 제공해야 하므로, 목록이 오래됐다면 해당 CLI도 업데이트하세요. 목록에 표시되더라도 실제 사용 가능 여부는 계정과 서비스의 응답에 따라 달라집니다.
조회 실패 시 마지막 정상 목록을 유지하며, 저장된 목록도 없으면 기본 모델 별칭을 표시합니다. 새 모델이 나타나도 현재 선택과 기본값은 자동으로 바뀌지 않습니다. 원하는 모델을 고른 뒤 s 또는 /model save로 기본값을 저장하세요.
네. gdmux와 gid는 각 사용자의 홈 폴더에 있는 설정을 읽습니다. 처음 설치하면 Tokyo Night로 시작하며, 이미 선택한 테마는 유지됩니다. 아래는 기본 설정 경로 기준입니다. 설정 파일을 먼저 백업하고, 기존 항목을 남긴 채 필요한 값만 합치세요.
선택형 스킨 예시: Black Glass. 아래 파일은 개인 취향에 맞게 색상을 바꾸는 예시입니다. 소개 화면은 기본 테마를 사용하며, 이 스킨은 원하는 경우에만 적용하세요.
gid: ~/.config/gid/config.json의 ui.theme에서 테마를 선택합니다. 아래는 해당 항목만 보여주는 예시입니다.
{
"ui": { "theme": "black-glass" }
}gid용 Black Glass JSON 받기 ↓ · 받은 파일을 ~/.config/gid/themes/black-glass.json에 저장하세요. 파일을 둔 뒤 대화에서 /theme black-glass로 선택할 수도 있습니다. 프로젝트의 .gid/settings.json에 테마가 있으면 개인 설정보다 우선합니다.
gdmux: ~/.config/gdmux/config.toml에서 [theme]와 [theme.colors]를 바꿉니다. gdmux용 Black Glass TOML 받기 ↓의 두 테마 섹션을 기존 파일에 합치세요. 같은 섹션을 중복으로 추가하거나 파일 전체를 덮어쓰지 마세요. 다음에 gdmux 화면을 열 때 적용됩니다.
반투명 배경: Black Glass의 바탕은 터미널 배경을 따릅니다. Ghostty에서 검정 배경과 투명도를 설정하면 바탕이 비치며, 글자를 읽는 패널은 어두운 불투명 색상을 유지합니다. 아래 값은 Ghostty 설정 예시이며 스킨 파일만으로 터미널 설정이 바뀌지는 않습니다.
background = 000000
background-opacity = 0.7
background-blur = true터미널이 투명 배경을 지원해야 하며 macOS의 네이티브 전체 화면에서는 불투명하게 보일 수 있습니다. gdmux를 --theme 또는 GDMUX_THEME로 실행하면 파일의 사용자 색상 대신 지정한 기본 테마가 적용됩니다.
기본 경로 기준으로, 제거할 도구의 실행 파일만 직접 삭제하세요. 아래 명령은 안내용이며 이 페이지에서 실행되지 않습니다.
gdmux와 함께 설치되는 실행 파일 4개:
rm ~/.local/bin/gdmux ~/.local/bin/gdmuxd ~/.local/bin/gdmuxctl ~/.local/bin/gdmux-remotegid와 gdm을 모두 제거할 때:
rm ~/.local/bin/gid ~/.local/bin/gdm둘 중 하나만 제거하려면 해당 실행 파일 경로만 남기세요. 다른 경로에 설치했다면 실제 설치 경로를 사용하세요.
작업·대화·계정 설정과 별도로 설치한 gdm 스킬은 남습니다. 스킬까지 제거하려면 에이전트 설정의 gdm hook을 먼저 해제하고 각 에이전트의 gdm-* 스킬을 삭제하세요. 다른 hook은 유지하세요.
gid의 AI 기능에는 공식 Codex 또는 Claude CLI와 해당 서비스 로그인이 필요합니다. gid auth status로 상태를 확인하고, 사용할 서비스에 따라 gid login codex 또는 gid login claude를 실행하세요.
이 설치에는 AI 서비스 이용권이 포함되지 않습니다. 로그인되지 않는다면 해당 공식 CLI의 로그인 상태도 확인하세요.
gid 첫 실행 안내macOS 13 이상에서 Apple Silicon과 Intel을 지원하는 공개 프리뷰입니다. 공개 실행 파일은 Developer ID 서명과 Apple 공증을 마쳤습니다. Rust·Bun 설치나 GitHub 로그인 없이 설치할 수 있습니다.
소스 저장소는 현재 private입니다. Windows·Linux용 공개 설치 파일은 아직 제공하지 않습니다.
iOS 17 이상에서 App Store의 gdmux 앱을 무료로 다운로드하세요. 원격 작업에는 켜져 있고 네트워크에 연결된 Mac과 연결 프로그램이 필요합니다.
Mac에서 아래 명령을 실행하고 안내에 따라 계정과 Mac을 연결합니다. iPhone 앱에서도 같은 계정을 사용하세요. gdmux 안에서는 Ctrl+B 다음 m으로 연결 설정을 열 수 있습니다.
gdmux --remoteiPhone에서 새 gid 작업을 만들려면 gid를 별도로 설치하거나 모두 설치를 선택하세요. 현재 Mac의 ~/.local/bin/gid를 사용하므로 기본 경로에 설치해야 합니다.