콘텐츠로 이동
Dotweave Dotweave v0.39.7

시작하기

dotweave를 설치하고 첫 동기화를 설정해 보세요.

  • Node.js 24 이상

npm install -g @tinyrack/dotweave

dotweave를 처음 사용한다면, 아래 단계를 따라 새로운 sync 디렉터리를 만들어 보세요.

  1. 초기화

    새로운 sync 디렉터리를 만들고 시크릿 암호화를 위한 age 키를 생성해요.

    dotweave init

    ~/.config/dotweave/에 Git 저장소와 age identity가 설정돼요.

  2. 파일 추적

    동기화할 파일을 dotweave에 알려주세요. 예를 들면:

    dotweave track ~/.zshrc
    dotweave track ~/.config/starship.toml
    dotweave track ~/.config/nvim

    SSH 키 같은 민감한 파일은 secret 모드를 사용하세요:

    dotweave track --mode secret ~/.ssh/config
  3. sync 디렉터리로 push

    추적 중인 파일을 sync 디렉터리에 복사해요:

    dotweave push
  4. Git으로 commit & push

    sync 디렉터리를 열고 리모트에 push하세요:

    dotweave cd
    git add -A && git commit -m "Initial sync"
    git remote add origin <your-repo-url>
    git push -u origin main

새 기기에서는 기존 sync 디렉터리를 clone해서 연결할 수 있어요:

  1. Clone & 초기화

    dotweave init <your-repo-url> --key "AGE-SECRET-KEY-1..."

    저장소를 ~/.config/dotweave/repository/로 clone해요. 기존 sync 저장소에 연결할 때는 시크릿 파일 복호화에 사용했던 age 비밀 키를 반드시 제공해야 해요. 키를 직접 입력하는 대신 붙여넣기 프롬프트를 사용할 수도 있어요:

    dotweave init <your-repo-url> --promptKey
  2. 파일 pull

    추적 중인 모든 파일을 로컬 경로로 복원해요:

    dotweave pull

설정을 마쳤으니, 가이드를 둘러보세요: