はじめに
dotweaveをインストールして、最初の同期を設定しましょう。
- Node.js 24以降
インストール
Section titled “インストール”npm install -g @tinyrack/dotweave新規セットアップ
Section titled “新規セットアップ”dotweaveを初めて使う場合は、以下の手順で新しいsyncディレクトリを作成します。
-
初期化
シークレット暗号化用のageキーを含む新しいsyncディレクトリを作成します。
dotweave initこれにより、
~/.config/dotweave/にGitリポジトリとageのidentityが設定されます。 -
ファイルをトラッキング
同期したいファイルをdotweaveに登録します。例えば:
dotweave track ~/.zshrcdotweave track ~/.config/starship.tomldotweave track ~/.config/nvimSSHキーなどの機密ファイルにはsecretモードを使います:
dotweave track --mode secret ~/.ssh/config -
syncディレクトリにpush
トラッキング中のファイルをsyncディレクトリにコピーします:
dotweave push -
Gitでcommit & push
syncディレクトリを開いてリモートにpushします:
dotweave cdgit add -A && git commit -m "Initial sync"git remote add origin <your-repo-url>git push -u origin main
既存のsyncディレクトリに接続する
Section titled “既存のsyncディレクトリに接続する”新しいマシンで、既存のsyncディレクトリをcloneします:
-
cloneして初期化
dotweave init <your-repo-url>リポジトリが
~/.config/dotweave/repository/にcloneされ、新しいageのidentityが設定されます。別のマシンのageプライベートキーをすでにお持ちの場合は、--keyで指定できます:dotweave init <your-repo-url> --key "AGE-SECRET-KEY-1..." -
ファイルをpull
トラッキング中のすべてのファイルをローカルパスに復元します:
dotweave pull
次のステップ
Section titled “次のステップ”セットアップが完了したら、各ガイドを読んでみましょう:
- ディレクトリ構造 — dotweaveがファイルを保存する場所を理解する
- ファイルのトラッキング — トラッキングオプションの詳細
- 同期モード — normal、secret、ignoreモード
- シークレットファイルの同期 — ageで機密ファイルを暗号化する