멀티 디바이스 워크플로우

초기 설정부터 일상적인 동기화까지의 전체 흐름을 알아보세요.

이 가이드에서는 dotweave 사용의 전체 생명주기를 다뤄요. 첫 기기 설정부터 여러 기기를 매일 동기화하는 것까지요.

기기 A에서의 초기 설정

dotweave 초기화
```
dotweave init ~/dotfiles
```
~/dotfiles에 Git으로 관리되는 sync 디렉터리가 생성돼요.

파일 추적

dotweave track ~/.gitconfig
dotweave track ~/.config/starship.toml
dotweave track ~/.ssh/config --secret

각 명령어는 sync 디렉터리 안의 manifest.jsonc에 항목을 추가해요.

로컬 파일을 sync 디렉터리로 push
```
dotweave push
```

Git으로 commit & 리모트에 push

dotweave는 Git commit을 자동으로 만들지 않아요. 모든 통제권은 사용자에게 있어요:

dotweave cd   # sync 디렉터리 안에서 셸을 열어요
git add -A && git commit -m "initial sync"
git remote add origin git@github.com:you/dotfiles.git
git push -u origin main
exit

기기 B 설정

리모트 URL로 초기화

dotweave init ~/dotfiles --url git@github.com:you/dotfiles.git

파일을 로컬 경로로 pull
```
dotweave pull
```
dotweave가 manifest.jsonc을 읽고, 플랫폼별 경로를 해석하고, 시크릿을 복호화한 뒤 모든 파일을 올바른 위치에 써줘요.

일상적인 워크플로우

두 기기 모두 설정을 마치면, 매일의 흐름은 간단하고 예측 가능해요.

변경사항이 있는 기기에서:

dotweave push
dotweave cd
git add -A && git commit -m "update shell aliases"
git push
exit

다른 기기에서:

dotweave cd
git pull
exit
dotweave pull

충돌 처리

sync 디렉터리는 일반 Git 저장소이므로 충돌도 일반적인 방법으로 해결해요:

dotweave cd
git pull            # merge 충돌이 발생할 수 있어요
# 해당 파일에서 충돌을 해결
git add -A && git commit -m "resolve merge conflict"
git push
exit
dotweave pull        # 해결된 상태를 로컬에 적용

상태 확인

dotweave doctor

sync 디렉터리의 존재 여부, Git 설정, 암호화 키, 추적 경로의 접근 가능 여부를 확인해 줘요.

기기 추가하기

세 번째(또는 네 번째, 다섯 번째) 기기를 추가하는 것도 기기 B와 같은 과정이에요 — 리모트 URL로 dotweave init을 하고 dotweave pull을 하면 돼요. 이후의 일상적인 push/pull 사이클은 모든 기기에서 동일해요.

빠른 참조

작업	명령어
변경사항 미리보기	`dotweave status`
로컬 수정을 업스트림으로	`dotweave push` → `git add -A && git commit` → `git push`
업스트림 수정 가져오기	`git pull` → `dotweave pull`
충돌 해결	`dotweave cd` → 파일 수정 → `git commit` → `git push`
설정 상태 확인	`dotweave doctor`