파일 추적하기

파일과 디렉터리를 동기화 대상으로 등록하는 방법을 알아보세요.

dotweave가 파일을 동기화하려면 먼저 추적해야 해요. 추적은 manifest.jsonc에 항목을 추가해서 “이 파일을 관리할 거야”라고 알려주는 거예요. 실제로 파일이 복사되거나 push되려면 이후에 dotweave push를 직접 실행해야 해요.

dotweave track에 파일 경로를 전달하세요:

dotweave track ~/.gitconfig
dotweave track ~/.zshrc

이렇게 하면 manifest.jsonc에 항목이 추가돼요. 그게 전부예요. 파일은 원래 위치에 그대로 있어요. 실제로 sync 디렉터리에 복사하려면 dotweave push를 별도로 실행하세요.

디렉터리 추적하기

디렉터리 전체를 추적할 수도 있어요. 디렉터리 안의 모든 파일이 (재귀적으로) push와 pull에 포함돼요.

dotweave track ~/.config/nvim
dotweave track ~/.config/fish

기본적으로 추적된 항목은 normal 모드를 사용해요. --mode로 변경할 수 있어요:

dotweave track ~/.ssh/config --mode secret
dotweave track ~/.local/share/cache-stuff --mode ignore

각 모드에 대한 자세한 설명은 동기화 모드를 참고하세요.

--profiles를 사용하면 항목을 하나 이상의 프로필에 할당할 수 있어요. 활성 프로필이 일치하는 기기에서만 해당 항목이 동기화돼요.

dotweave track ~/.config/work-tool --profiles work
dotweave track ~/.config/shared-tool --profiles work,personal

--profiles 없이 추적한 항목은 default 프로필에 들어가서 모든 기기에서 동기화돼요. 자세한 내용은 프로필을 참고하세요.

기본적으로 dotweave는 홈 디렉터리 기준 상대 경로를 sync 디렉터리 안에 그대로 미러링해요. 저장소 안에서 다른 경로를 사용하고 싶다면 --repoPath를 사용하세요:

dotweave track ~/Projects/scripts/deploy.sh --repoPath scripts/deploy.sh

화이트리스트 방식: 동기화하고 싶은 파일만 골라서 추적:

dotweave track ~/.gitconfig
dotweave track ~/.zshrc
dotweave track ~/.config/starship.toml
dotweave push

블랙리스트 방식: 디렉터리 전체를 추적한 뒤, 특정 하위 파일만 제외:

dotweave track ~/.config/nvim
dotweave track ~/.config/nvim/plugin/packer_compiled.lua --mode ignore
dotweave push

마음이 바뀌었다면 dotweave untrack으로 항목을 제거할 수 있어요:

dotweave untrack ~/.gitconfig

manifest.jsonc에서 항목이 제거돼요. 로컬 파일이나 sync 디렉터리에 있는 기존 복사본은 삭제되지 않아요.

dotweave status로 모든 추적 항목과 현재 상태를 확인할 수 있어요:

dotweave status

--dry-run을 추가하면 실제 적용 없이 변경 사항을 미리 볼 수 있어요:

dotweave push --dry-run
dotweave pull --dry-run