# gdmux · gid · gdm — 설치와 첫 실행

macOS 13 이상 · Apple Silicon / Intel · 공개 프리뷰 `preview-20261002.1`

| 도구 | 하는 일 |
|---|---|
| **gdmux** | 터미널 작업을 탭·화면 분할로 관리하고 iPhone과 연결합니다. |
| **gid** | Codex·Claude 계정으로 대화하며 코딩하는 터미널 AI 앱입니다. |
| **gdm** | 코딩 작업의 요구사항·검증 명령·실행 증거를 관리합니다. |

소스 저장소는 현재 private입니다. 아래 주소에서 실행 파일과 사용에 필요한 스킬을 받습니다.
Rust·Bun·GitHub 로그인 없이 설치할 수 있습니다. AI 사용에는 별도의 Codex 또는 Claude CLI와 해당 서비스의 로그인이 필요합니다.

## 세 도구 한 번에 설치

```sh
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh
```

첫 줄은 설치 스크립트를 내려받고, 둘째 줄이 세 도구를 설치합니다.
이미 설치했다면 같은 명령으로 업데이트할 수 있습니다.

## 필요한 도구만 설치

### gdmux만

```sh
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh --tool gdmux
```

### gid만

```sh
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh --tool gid
```

### gdm만

```sh
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh --tool gdm
```

선택한 도구만 설치하며, 다른 도구의 기존 설치는 유지합니다.

| 선택 | 설치되는 실행 파일 |
|---|---|
| `gdmux` | `gdmux` 화면, `gdmuxd` 세션 관리, `gdmuxctl` 제어, `gdmux-remote` iPhone 연결 |
| `gid` | `gid` 코딩 AI |
| `gdm` | `gdm` 작업 검증 CLI |
| 생략 또는 `all` | 위 실행 파일 6개 |

### 설치 경로와 PATH

기본 설치 경로는 `~/.local/bin`입니다. 이 폴더가 셸의 명령 검색 경로인 PATH에 없으면 설치 후에도 명령을 찾지 못합니다.
설치기가 PATH 안내를 표시하면 셸 설정 파일(zsh는 `~/.zshrc`)에 다음 줄을 추가하고 새 터미널을 여세요.

```sh
export PATH="$HOME/.local/bin:$PATH"
```

다른 설치 경로는 `--prefix /절대/경로`로 지정합니다. 실행 파일은 그 경로의 `bin` 폴더에 설치됩니다. `sudo`로 실행하지 마세요.

현재 iPhone에서 새 gid 작업을 만들 때는 Mac의 `~/.local/bin/gid`를 찾습니다.
iPhone 연결을 사용할 예정이면 gid는 기본 경로에 설치하세요. 커스텀 경로를 PATH에 추가하는 것만으로 이 경로가 바뀌지는 않습니다.

### `.tar.gz` 다운로드는 수동 설치용

[소개 페이지](https://gdmux.pages.dev/#install)의 압축 파일 링크는 설치 파일을 내려받기만 합니다.
`.tar.gz`를 받는 것만으로 명령이 설치되지는 않습니다. 각 압축에는 해당 도구의 `bin/` 실행 파일과 README·라이선스가 들어 있습니다.
수동 설치 시 체크섬과 서명을 확인한 뒤 실행 파일을 PATH에 포함된 폴더로 옮겨야 합니다.
위 curl 방식은 이 다운로드·검증·배치를 설치기가 처리하므로, 바로 사용하려면 curl 명령을 권장합니다.

### gdm 스킬까지 설치

```sh
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh --tool gdm --with-skills
```

세 도구와 스킬을 함께 설치하려면 둘째 줄에서 `--tool gdm`을 빼세요.
Codex·Claude·Pi용 gdm 스킬, `gdm-pi` 실행기와 Codex 작업 게이트를 설치합니다.
기존 gdm 스킬은 업데이트하며, Codex hook 설정은 기존 내용을 보존하고 백업합니다.
필요하면 셸 설정에 PATH를 추가합니다. 다른 에이전트의 로그인 정보는 복사하지 않습니다.
이미 열려 있는 AI 세션은 새로 시작해야 새 스킬을 인식합니다.

## gdmux 시작

```sh
gdmux
```

`Ctrl+B`를 누른 뒤 다음 키를 누릅니다.

| 키 | 동작 |
|---|---|
| `a` | 새 작업 실행 |
| `v` / `s` | 화면 분할 |
| `w` | 전체 작업 보기 |
| `p` | 명령 검색 |
| `?` | 단축키 도움말 |
| `m` | iPhone 연결 설정 |

`Ctrl+Q`는 화면에서 나갑니다. 작업 프로세스는 계속 실행됩니다.
평소 쓰는 셸과 터미널 앱을 사용할 수 있으며, 24비트 색상을 지원하는 최신 터미널을 권장합니다.

### iPhone과 연결

```sh
gdmux --remote
```

안내에 따라 계정과 Mac을 연결하세요. iPhone 앱과 같은 계정을 사용합니다.
실제 원격 작업은 Mac과 연결 프로그램이 실행 중이고 네트워크에 연결되어 있어야 합니다.
iPhone 앱은 App Store 심사 중이며, Apple 승인 후 제공됩니다.

## gid 시작

공식 Codex 또는 Claude CLI를 먼저 설치한 뒤 로그인합니다.

```sh
gid auth status
gid login codex       # 또는: gid login claude
gid --cwd ~/projects/my-project
# Claude 사용:
gid --provider claude --cwd ~/projects/my-project
```

`my-project`는 실제 프로젝트 폴더로 바꾸세요. 프로젝트에서 `gid`만 실행해도 됩니다.
gdmux 안에서는 `Ctrl+B`, `a`로 gid를 선택할 수 있습니다.

## gdm 시작

```sh
gdm --help
gdm doctor
```

스킬을 설치했다면 프로젝트에서 Claude 또는 Codex를 새로 실행해 요청하세요.

```text
/gdm-go 로그인 오류를 수정하고 검증까지 완료해줘
/gdm-plan 검색 기능 구현을 계획해줘
```

Codex에서는 `$gdm-go`, `$gdm-plan`으로 사용할 수 있습니다. Pi 사용자는 별도로 Pi를 설치한 뒤 `gdm-pi`로 시작하세요.
`gdm-full`의 독립 검수는 구현과 다른 모델이 필요합니다. 우선 일상 작업에는 `gdm-go`를 사용하세요.

## 업데이트 · 제거

업데이트는 설치 명령을 다시 실행합니다. 특정 프리뷰를 설치하려면 `--version preview-20261002.1`을 지정하세요.
실행 중인 gdmux 세션은 설치 후에도 기존 백그라운드 프로그램을 사용합니다. 작업을 마친 뒤 모든 세션을 닫고 gdmux를 새로 시작하면 새 버전으로 실행됩니다.
설치기는 실행 중인 작업을 종료하지 않습니다.

제거는 설치한 실행 파일만 지우면 됩니다. 기본 경로 기준:

```sh
rm ~/.local/bin/gdmux ~/.local/bin/gdmuxd ~/.local/bin/gdmuxctl ~/.local/bin/gdmux-remote
rm ~/.local/bin/gid ~/.local/bin/gdm
```

작업·대화·계정 설정과 별도 설치한 gdm 스킬은 남아 있습니다. 스킬까지 제거할 때는 에이전트 설정의 gdm hook을 먼저 해제하고 각 에이전트의 `gdm-*` 스킬을 삭제하세요. 다른 hook은 유지하세요.

## 설치 문제

- `command not found`: `~/.local/bin`이 PATH에 있는지 확인하고 새 터미널을 여세요.
- 기존 경로가 symlink라고 표시됨: 연결 대상과 기존 설치 방식을 확인하고 다른 `--prefix`를 선택하세요.
- 체크섬·서명 오류: 설치를 중단하고 설치 파일을 다시 다운로드하세요.
- AI 로그인이 안 됨: `gid auth status`로 확인하고 해당 공식 CLI의 로그인을 진행하세요.
- 실행 중인 세션이 이전 UI를 표시함: 설치는 기존 작업을 중단하지 않습니다. 세션을 정리한 뒤 다시 시작하세요.

지원: https://15.165.211.112/support