dotweave init

Initialize the git-backed sync directory.

Create or connect the sync directory under your XDG config directory, then store the sync settings used by later pull and push operations. If you omit the repository argument, dotweave initializes a local git repository in the sync directory.

Usage

dotweave init [repository]

Arguments

Argument	Description
[repository]	Remote URL or local git repository path to clone. Optional — when omitted, a new local repository is created.

Flags

Flag	Description
--key <age-private-key>	Persist an age private key into the identity file.
--promptKey	Prompt to enter an age private key instead of generating one automatically.
--verbose	Show detailed output.

Examples

Initialize a fresh local sync directory:

dotweave init

Clone a remote repository as the sync directory:

dotweave init https://github.com/user/dotfiles.git --key "AGE-SECRET-KEY-1..."

Initialize with an existing age secret key:

dotweave init --key "AGE-SECRET-KEY-1..."

Tip

If you pass a repository to dotweave init, you must also provide the existing age private key with --key or --promptKey so dotweave can decrypt your secret files.