Dotfiles
@puddleworks/dotfilesv2026.11.09.2
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.
03Behaviors
@puddleworks/dotfilesv2026.11.09.1dotfiles.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| sourceDir? | string | Directory holding the files items copy from. Relative paths are resolved from the swamp repository root |
| vars? | record | Extra {{variables}} for templates and destinations |
| items? | array | What 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 Versions
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
Repository
https://github.com/mesgme/swamp-dotfilesdeno-command1 accepted
Spawns a subprocess with Deno.Command().
- models/runner.ts:40 — running sh locally and ssh remotely is the purpose of this extension; arguments are shell-quoted with shq()
07Platforms
08Labels