Skip to main content

Dotfiles

@puddleworks/dotfilesv2026.11.09.2· MIT· 12d agoBEHAVIORSACCEPTED WARNINGS
01README

Bring a local or ssh-reachable machine to a declared dotfiles state: files, directory trees, packages (brew/apt), git clones and guarded commands. Idempotent plan, apply and verify.

02Release Notes

Manifest points at the public source repository https://github.com/mesgme/swamp-dotfiles. No code changes.

03Behaviors1
@puddleworks/dotfilesv2026.11.09.1dotfiles.ts

Global Arguments

ArgumentTypeDescription
sourceDir?stringDirectory holding the files items copy from. Relative paths are resolved from the swamp repository root
vars?recordExtra {{variables}} for templates and destinations
items?arrayWhat the machine should have, applied in order
fn plan()
Show what apply would change, without changing anything
fn apply()
Bring the machine to the declared state; safe to repeat
fn verify()
Fail if the machine differs from the declared state

Resources

report(infinite)— What a plan, apply or verify run found on the machine
04Previous Versions1
2026.11.09.1MIT

Initial release: files, trees, brew/apt packages, git clones and guarded commands; idempotent plan, apply and verify over local or ssh.

05Stats
B
87 / 100
Downloads
4
Archive size
19.3 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository0/2missing

07Platforms
08Labels