Skip to main content
Agate ships a dotfiles manager integration powered by yadm, installed via a COPR repository. A set of just tasks wraps the most common yadm workflows so you can bootstrap, sync, and apply your dotfiles without remembering the underlying commands.
These tasks use yadm under the hood. Before running them, make sure you have a dotfiles repository configured and accessible from your system.

Available tasks

TaskDescription
just dotfiles-bootstrapInitializes your dotfiles setup on a fresh system
just dotfiles-syncSyncs dotfiles from your remote repository
just dotfiles-applyApplies dotfiles to the current system
just dotfiles-inspectShows the current dotfiles state and configuration
just dotfiles-cleanRemoves dotfiles artifacts and state

Typical workflow

Follow these steps after a fresh Agate install to get your dotfiles in place.
1

Bootstrap your dotfiles setup

Run dotfiles-bootstrap to initialize yadm and prepare the system for your dotfiles.
just dotfiles-bootstrap
2

Sync from your remote repository

Pull your dotfiles from the remote repository you have configured.
just dotfiles-sync
3

Apply dotfiles to the system

Apply your dotfiles to their target locations on disk.
just dotfiles-apply
4

Verify the result

Inspect the current dotfiles state to confirm everything applied correctly.
just dotfiles-inspect

Cleaning up

If you need to remove your dotfiles artifacts and reset the state, run:
just dotfiles-clean
Learn more about yadm — including alternate files, encryption, and bootstrap scripts — in the official yadm documentation.
Last modified on April 7, 2026