devsync track

로컬 파일이나 디렉터리를 동기화 대상으로 등록해요.

형식

devsync track <path> [<path>...]

devsync track은 하나 이상의 로컬 경로를 manifest.json에 등록해서 이후 push와 pull 작업에 포함되도록 해요.

경로는 홈 디렉터리($HOME) 하위에 있어야 해요. manifest에는 홈 기준 상대 경로로 저장되며, 실행 시에는 절대 경로로 변환돼요.

이미 추적 중인 경로는 모드와 프로파일만 갱신돼요.

동기화된 파일은 ~/.config/devsync/sync/{profile}/{홈 기준 상대 경로}에 저장돼요. 프로파일이 없는 항목은 루트 레벨에 저장돼요.

인수	설명
`path`	추적할 절대 경로 또는 `~`로 시작하는 경로. 하나 이상 필수예요.

플래그	설명
`--mode normal\|secret\|ignore`	동기화 모드. 기본값은 `normal`이에요.
`--profile NAME`	항목을 특정 프로파일에 할당해요. 반복 사용해서 여러 프로파일에 동시 할당할 수 있어요. 생략하면 전역 항목이 돼요.
`--verbose`	상세 출력을 표시해요.

모드	설명
`normal`	파일 또는 디렉터리 내용을 그대로 저장소에 저장해요.
`secret`	저장소에 쓰기 전에 age로 파일을 암호화해요. `{파일명}.devsync.secret`으로 저장되고, 원본 파일은 절대 평문으로 저장되지 않아요.
`ignore`	manifest에 경로를 등록하지만 `push`와 `pull` 시에는 완전히 건너뛰어요. 동기화하지 않으면서 경로 존재를 기록해 두고 싶을 때 유용해요.

# ~/.gitconfig를 기본(normal) 모드로 추적
devsync track ~/.gitconfig

# 여러 dotfile을 한 번에 추적
devsync track ~/.gitconfig ~/.zshrc ~/.tmux.conf

# SSH 개인 키를 암호화해서 저장소에 저장
devsync track ~/.ssh/id_ed25519 --mode secret

# VS Code 설정을 "work" 프로파일에만 할당
devsync track ~/.config/Code/User/settings.json --profile work

# 설정 디렉터리 전체를 추적
devsync track ~/.config/nvim

# .ssh 전체는 normal 모드로, 개인 키만 secret 모드로
devsync track ~/.ssh
devsync track ~/.ssh/id_ed25519 --mode secret