A personal collection of dotfiles and scripts for syncing settings across machines.
README.md

dotfiles #

Personal dotfiles and setup scripts for macOS machines and ephemeral Linux sandboxes.

The primary repository lives on tangled.org and mirrors to github.com.

Visibility: Public repository. Use synthetic placeholders (acme, example.com, <host>) in docs and examples. Exclude internal hostnames, private URLs, IP addresses, account IDs, and credentials.

Setup #

  1. Install the prerequisite Mac apps in docs/APPS.md, starting with 1Password, Xcode, and Tailscale.

  2. Bootstrap packages, symlinks, Node, CLI updates, and macOS defaults:

    just install
    
  3. For repo-root linting and formatting (just lint, just format), install the pinned tools in mise.toml:

    mise install
    

Key just commands #

Run just or just --list for all recipes under justfile and just/.

  • just link — symlink configs and copy Herdr mods via bin/link.sh
  • just brew — install Homebrew formulas and casks from Brewfile
  • just node — install and pin ambient Node (26 in mise/config.toml) via mise; removes any leftover ~/.nub/node-shim
  • just install-omlx — install or upgrade the latest macOS oMLX app via bin/install-omlx.sh
  • just uzu-install — build uzu from source (see docs/UZU.md)
  • just firecrawl-install — install firecrawl-local into ../_cli and link it into ~/.local/bin (see docs/FIRECRAWL.md)
  • just install-beszel-agent <hub_url> <key> <token> — opt-in Beszel monitoring agent (see docs/BESZEL.md)
  • just ssh-add-key — load the SSH key from 1Password into ssh-agent (see docs/1PASSWORD_SSH.md)

Structure and docs #

  • AGENTS.md and .agents/AGENTS.md — repository rules and cross-project agent defaults
  • herdr-app/ — Herdr keys, settings, Dark Greeny theme, layout, and sidebar/tab mods (just link copies mods because Herdr does not hot-reload symlinks)
  • factory/ — shared Droid config; move an existing ~/.factory/settings.json to ~/.factory/settings.local.json before the first just link so shared defaults do not overwrite machine-specific settings, and keep ~/.factory/ itself local
  • .pi/ — pi coding agent config, extensions, and sops-encrypted env
  • skills/ — portable Agent Skills and plugin manifests (plugin.json, .cursor-plugin/, .claude-plugin/)
  • sandbox/ — ephemeral Linux sandboxes via just nsc-start
  • moshi/, k9s/, keyboard/ — Moshi iOS theme, k9s config, and QMK/VIA macro pad
  • fx — just link symlinks only ~/.fx/AGENTS.md; keep ~/.fx/ local because fx refuses durable state in git-tracked paths, and install/upgrade with just install-fx (just/install.just)

Guides in docs/:

Author #

Created by frytg.digital

License #

MIT