# 명령 레퍼런스

> 모든 명령과 옵션입니다.

## 시작과 계정

| 명령 | 설명 |
|---|---|
| `aisync scan [--from DIR]` | 하드코딩된 토큰을 찾습니다. 로그인 없이 로컬만 읽습니다 |
| `aisync login [--repo owner/name] [--branch B]` | gh 로그인으로 리포를 연결합니다. 없으면 private으로 만듭니다 |
| `aisync logout` | 이 컴퓨터에서 리포 설정과 키를 지웁니다. gh 로그인은 그대로입니다 |
| `aisync status` | 로그인, 리포, 저장소 잠금 상태, 프로필 목록 |
| `aisync list` | 프로필과 설정 폴더, 이 컴퓨터에 적용된 상태 |

## 프로필

| 명령 | 설명 |
|---|---|
| `aisync new NAME [--extends BASE] [--config-dir DIR]` | 리포에 프로필을 만듭니다 |
| `aisync capture NAME [--from DIR] [--server S]… [--vault MOUNT/PREFIX] [--force]` | 이 컴퓨터의 설정으로 프로필을 만듭니다. MCP 토큰은 암호화 저장소(또는 Vault)로 옮깁니다 |
| `aisync diff NAME` | 받으면 무엇이 바뀌는지 보여 줍니다 |
| `aisync pull NAME [--dry-run] [--force]` | 리포의 프로필을 설정 폴더에 적용합니다. `--force`는 충돌 시 리포 것을 받습니다(내 것은 백업) |
| `aisync push NAME [-m MSG] [--add PATH]… [--add-server S]… [--secrets] [--force]` | 고친 것을 올립니다. `--secrets`는 새 평문 토큰을 저장소로 옮기고, `--force`는 충돌 시 내 것을 남깁니다 |
| `aisync run NAME [-- ARGS…]` | 프로필의 설정 폴더와 환경변수로 claude를 실행합니다 |

## 시크릿

| 명령 | 설명 |
|---|---|
| `aisync secret list` | 이름 목록 |
| `aisync secret set NAME [VALUE]` | 추가하거나 바꿉니다. 값을 생략하면 입력받습니다 |
| `aisync secret get NAME` | 값을 출력합니다 |
| `aisync secret rm NAME` | 지웁니다 |
| `aisync secret prune [--dry-run]` | 어느 프로필도 쓰지 않는 것을 지웁니다 |
| `aisync passwd` | 패스프레이즈를 바꾸고 저장소를 새로 암호화합니다 |
| `aisync unlock` | 이 컴퓨터에서 패스프레이즈를 입력해 키를 저장합니다 |
| `aisync vault login --addr URL` | Vault 토큰을 저장합니다 |
| `aisync vault token` | 그 토큰을 출력합니다(스크립트용 `VAULT_TOKEN=$(aisync vault token)`) |
| `aisync keystore [file\|keychain]` | 이 컴퓨터가 키를 둘 곳. 사람이 없는 맥은 file |

## 기타

| 명령 | 설명 |
|---|---|
| `aisync ui [--port N] [--no-open]` | 어드민 UI를 엽니다 |
| `aisync exec --repo R -- CMD…` | Claude Code가 MCP 서버를 띄울 때 쓰는 명령입니다. 직접 실행하면 서버 오류를 볼 수 있습니다 |
| `aisync headers --repo R K=V…` | HTTP MCP 서버의 headersHelper |
| `aisync version` | 버전 |

## 환경변수

| 이름 | 설명 |
|---|---|
| `GH_TOKEN`, `GITHUB_TOKEN` | 있으면 `gh auth token` 대신 씁니다 |
| `AISYNC_KEYSTORE` | `aisync keystore`로 저장한 값보다 우선합니다(CI용) |
| `AISYNC_PASSPHRASE` | 패스프레이즈를 묻지 않고 이 값을 씁니다(CI용) |
| `AISYNC_CONFIG_DIR` | aisync 설정 위치(기본 `~/.config/aisync`) |
| `VAULT_ADDR`, `VAULT_TOKEN` | 있으면 저장된 Vault 설정 대신 씁니다 |