DotweaveDotweave
DocsGitHub
DotweaveDotweave
    • Introduction
    • Install Dotweave
    • Set up your first sync
    • Set up a second device
    • How syncing works
    • Directory and repository layout
    • Sync modes
    • Profiles
    • Platform-specific paths
    • Secrets and encryption
    • Track files and directories
    • Push, review, and commit day to day
    • Keep several devices in sync
    • Enable shell autocomplete
    • Install the agent skill
    • Upgrade config and repository formats
    • Troubleshoot a broken sync
    • dotweave init
    • dotweave track
    • dotweave push
    • dotweave pull
    • dotweave status
    • dotweave untrack
    • dotweave cd
    • dotweave profile
    • dotweave doctor
    • dotweave autocomplete
    • dotweave skill
    • manifest.jsonc
    • settings.jsonc
    • Environment variables and paths
    • Error messages
DocsGitHub
  1. Dotweave/
  2. Install Dotweave

Install Dotweave

Install the CLI on Windows, macOS, or Linux, and confirm the git binary Dotweave requires.

Install the dotweave CLI and confirm it can find git. Dotweave ships as a compiled native binary, so there is no runtime to install alongside it. You need git available on your PATH.

1. Install the CLI

winget install tinyrack.dotweave

Confirm the install:

dotweave --version
dotweave/1.0.0

2. Confirm the git binary

Dotweave uses git as its transport, but it does not bundle one. Every command except dotweave skill install needs git on your PATH.

git --version

If that fails, install git and open a new shell. Dotweave reports a missing git as Git is not installed or not on PATH.

You do not need to install age. The encryption Dotweave uses for secret files is built into the CLI.

Check the result

Run the health check. It exits non-zero and reports a git failure until you initialize a sync directory, which is expected before first-time setup:

dotweave doctor

Once you have run dotweave init, the same command reports every check as passing:

· Running checks...
✔ Doctor passed (6 ok · 0 warnings · 0 failures)

Dotweave stores its data under %APPDATA%\dotweave on Windows and $XDG_CONFIG_HOME/dotweave (usually ~/.config/dotweave) elsewhere. Nothing is written until you run dotweave init.

Continue with Set up your first sync to create a sync directory, or read Enable shell autocomplete to get tab completion first.

← PreviousOverviewIntroductionWhat Dotweave does, how it differs from symlink and template based dotfile managers, and what it deliberately leaves to git.→ NextOverviewSet up your first syncInitialize the sync directory, track your first files, push them, and publish the repository with git.

On this page

  1. 1. Install the CLI
  2. 2. Confirm the git binary
  3. Check the result