Something went wrong. Try again.
A personal collection of dotfiles and scripts for syncing settings across machines.
Something went wrong. Try again.
Files
Verified signature Signed by frytg.digital SHA256:g4e4LyMUsNvVcLxN53oxTb+IZ9E6oafEw33pWJrtkfQ Click to copy SHA
Verified signature Signed by frytg.digital SHA256:g4e4LyMUsNvVcLxN53oxTb+IZ9E6oafEw33pWJrtkfQ Click to copy SHA
Verified signature Signed by frytg.digital SHA256:g4e4LyMUsNvVcLxN53oxTb+IZ9E6oafEw33pWJrtkfQ Click to copy SHA
- JavaScript 48%
- TypeScript 35%
- Shell 17%
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 #
-
Install the prerequisite Mac apps in
docs/APPS.md, starting with 1Password, Xcode, and Tailscale. -
Bootstrap packages, symlinks, Node, CLI updates, and macOS defaults:
just install -
For repo-root linting and formatting (
just lint,just format), install the pinned tools inmise.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 viabin/link.shjust brew— install Homebrew formulas and casks fromBrewfilejust node— install and pin ambient Node (26inmise/config.toml) via mise; removes any leftover~/.nub/node-shimjust install-omlx— install or upgrade the latest macOS oMLX app viabin/install-omlx.shjust uzu-install— build uzu from source (seedocs/UZU.md)just firecrawl-install— install firecrawl-local into../_cliand link it into~/.local/bin(seedocs/FIRECRAWL.md)just install-beszel-agent <hub_url> <key> <token>— opt-in Beszel monitoring agent (seedocs/BESZEL.md)just ssh-add-key— load the SSH key from 1Password intossh-agent(seedocs/1PASSWORD_SSH.md)
Structure and docs #
AGENTS.mdand.agents/AGENTS.md— repository rules and cross-project agent defaultsherdr-app/— Herdr keys, settings, Dark Greeny theme, layout, and sidebar/tab mods (just linkcopies mods because Herdr does not hot-reload symlinks)factory/— shared Droid config; move an existing~/.factory/settings.jsonto~/.factory/settings.local.jsonbefore the firstjust linkso shared defaults do not overwrite machine-specific settings, and keep~/.factory/itself local.pi/— pi coding agent config, extensions, and sops-encrypted envskills/— portable Agent Skills and plugin manifests (plugin.json,.cursor-plugin/,.claude-plugin/)sandbox/— ephemeral Linux sandboxes viajust nsc-startmoshi/,k9s/,keyboard/— Moshi iOS theme, k9s config, and QMK/VIA macro padfx—just linksymlinks only~/.fx/AGENTS.md; keep~/.fx/local becausefxrefuses durable state in git-tracked paths, and install/upgrade withjust install-fx(just/install.just)
Guides in docs/:
docs/APPS.md— manual Mac and App Store installs outsideBrewfiledocs/MCP.md— MCP server configs across pi, Claude Code, Cursor, Droid, and Devindocs/1PASSWORD_SSH.md— service-account SSH agent and Git commit signingdocs/SSH.md— YubiKey PIV SSH setupdocs/BACKUPS.md— age key creation and sops secret managementdocs/BESZEL.md— Beszel agent installation and Homebrew tap gotchadocs/UZU.md— building, running, and publishing uzu over Tailscaledocs/DESIGN.md— Dark Greeny visual design system for web and iOSdocs/NATIVE_APP_DEV.md— SwiftUI/XcodeGen patterns and UI test harness notes
Author #
Created by frytg.digital