Repository Model

Source of Truth

For every managed file:

  1. The original file is moved from $HOME into the Tildr repository
  2. A symlink is created at the original location in $HOME
  3. Future reads and edits should happen against the repository-backed file

Example:

$HOME/.config/nvim/init.lua            -> symlink
$HOME/.dotfiles/.config/nvim/init.lua  -> real file

Default Paths

  • Default repository: ~/.dotfiles
  • Config file: ~/.config/tildr/config.toml
  • If XDG config resolution is unavailable, Tildr falls back to $HOME/.config/tildr/config.toml

Filesystem Constraint

Tildr is designed to operate with the repository and managed files inside the same $HOME filesystem.

  • The repository is required to live inside $HOME
  • The repository cannot be $HOME itself
  • Cross-disk repository layouts are not a supported workflow
  • In practice, you should keep the Tildr repository inside your home directory and on the same filesystem as the files you manage

This means Tildr is not intended for copying files from your home directory to a repository stored on another disk or external mount. Keep the repository in $HOME.