Skip to content
radiosilencePublic

About

dotfiles for zsh and other friends

Resources

Stars

7 stars

Watchers

2 watching

Forks

Repository files navigation

dotfiles

Personal dev environment. macOS and headless Linux, zsh throughout.

Setup

macOS:

curl -fsSL https://raw.githubusercontent.com/radiosilence/dotfiles/main/setup-macos | zsh

Sequential bootstrap (xcode → Touch ID for sudo → brew → 1Password → clone) and then hands off to task converge for everything else — mise, symlinks, completions, fonts, gh auth. Idempotent; re-running skips what's already done.

Linux (Ubuntu/Debian, headless):

curl -fsSL https://raw.githubusercontent.com/radiosilence/dotfiles/main/setup-linux | bash

bash, because zsh isn't installed yet. Shorter path — apt base packages → mise → clone → gh device-flow auth → task converge. Same Taskfile, same upd; the darwin-only tasks (brew, casks, Touch ID, 1Password, use-ssh, secrets:populate) skip themselves.

No 1Password on a headless box, so git auth is gh's credential helper over HTTPS and secrets aren't populated. If you want signed commits there, ssh -A in from a machine that has the agent.

Where root is allowed: bootstrap may install system packages; the Taskfile may not. converge runs unattended, so on Linux it stays entirely under $HOME — mise in ~/.local, tools in ~/.local/share/mise, configs symlinked into ~. apt:core, apt:upgrade and dnf:upgrade exist but you run them by hand. brew is the exception that isn't one: it's user-owned and installs formulae without root, so brew:bundle stays in converge.

The apt list is short by design: zsh git curl ca-certificates gh rsync gnupg unzip aria2 lsof libimage-exiftool-perl. Nothing there is in mise's registry, and everything that is comes from mise. core.rb's coreutils/findutils/openssl/make are macOS un-BSD-ing and have no Linux equivalent worth installing.

Run upd (or converge) anytime to update everything. Tasks that need gh auth poll silently until ready.

What's Here

  • Shell configs — Modular zsh setup with 30+ config files, 80+ git aliases, fzf-tab completions
  • scripts/ — System maintenance, git workflow, media processing, file operations, in zsh
  • Taskfile.yml — DAG-based system management (bootstrap, update, completions, fonts)
  • Tool management — mise for runtimes, role-based Brewfile for system packages (brewfiles.d/)
  • Terminal configs — zellij, ghostty, starship prompt
  • Editor configs — helix (LSP, tree-sitter, formatters for 15+ languages), zed

Documentation

Doc Description
cheatsheet.md Complete reference — all commands, aliases, functions
new-tools.md Modern CLI replacements (dust, procs, delta, xh, oha, tokei)
fzf-tab-completions.md Fuzzy completion setup with previews
CHANGELOG.md Full history from 2018 to present

Highlights

System

  • upd / converge — Converge system to desired state (bootstrap + update in one command)
  • task --list — See all available tasks
  • kill-port <port> — Kill process on port
  • prune — Find and delete small directories

Git workflow

  • git sync — Delete merged local branches
  • git squash — Squash commits for clean PRs
  • fm / fr — Fuzzy merge/rebase with fzf

Worktrees (wt*) — git worktree management, as local zsh plugins under zsh-plugins/: wt-core plus a backend per multiplexer (wt-herdr, wt-zellij). Worktrees live in <repo-parent>/worktrees/<repo>/<name>/ — outside the repo so editors don't recurse into them.

  • wt / wt <name> — Upsert worktree + cd (fzf picker with no args)
  • wtt / wth — Same, opening a Zellij tab / Herdr app space instead (keys: docs/herdr-app.md)
  • wt -b <name> — Branch from current HEAD instead of origin/main
  • wtpr <n|url> — Worktree for a GitHub PR or issue (handles forks); wti for issues only. In the Herdr app, grove picks worktrees, PRs, issues and folders in one dialog
  • wtrm [name] — Remove the worktree you're in (or a named one) + its branch
  • wtclean [-n] — GC worktrees and branches whose PR is merged or closed, per gh. Keeps anything dirty

Media

  • to-audio opus|flac — Parallel audio conversion
  • embed-art — Embed cover art into FLACs
  • imp — Download + extract + sift import

Files

  • vimv — Batch rename in $EDITOR
  • clean-dls — Remove scene release garbage

These live in scripts/ as zsh — see there for what each one does, with examples. Nothing is sourced by path — the shell exports FPATH, so a script just names the functions it wants. Output helpers live in scripts/lib/functions/; the interface is declared with zarg, which derives parsing, --help, --version and --completions zsh|fish|bash from that one declaration, so a script's completions cannot drift from the flags it actually accepts.

Architecture Notes

Merging — git.d/merge.conf and git.d/attributes route merges through mergiraf, which merges syntax trees instead of lines. GitHub does not run custom merge drivers, so merge the base in locally to clear a PR conflict.

Git signing — git.d/sign.conf sets the format, signer program and commit.gpgsign; the identity half (user.email, user.signingkey, allowed_signers) is per-machine and lives in ~/.gitconfig, written by task git:signing from the 1Password agent and account. Nothing key-shaped is committed, and a fresh box gets it from converge.

Claude reminders — .claude-personal/hooks/reminders.sh is a UserPromptSubmit hook that reads ~/REMINDERS.md (a free-form list of medication, meals and chores, kept out of the repo because it is personal) and asks Haiku whether anything is due. The reminder is added to the prompt's context, so it appears in whichever session is in use and not in idle ones. Today's state (what was done, snoozes, past reminders) lives in ~/.local/state/claude-reminders/ and is shared by all sessions, so marking an item done in one stops reminders for it in all of them. Haiku is asked at most once per 15 minutes (REMINDERS_INTERVAL, in seconds) across all sessions; the other prompts only update a timestamp. Without ~/REMINDERS.md the hook does nothing.

Tool duplication — Some tools exist in both brew and mise intentionally:

  • sheldon — brew for Intel (no arm64 binary), mise for Apple Silicon
  • uv — official astral standalone installer (system-wide Python tooling)

Syncthing

brew services start syncthing

Web UI at http://localhost:8384. Stop: brew services stop syncthing.

Related

About

dotfiles for zsh and other friends

Resources

Stars

7 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages