Skip to content

Deavon's Dotfiles

Configuration for macOS terminal environments

This repository is a curated, stow-managed dotfiles setup for macOS. It provisions a coherent terminal environment around Ghostty, Zsh, tmux, oh-my-posh, and LazyVim, all skinned with the cyberdream palette, plus a security-key-driven Git workflow and a small fleet of custom scripts.

Demo

A recorded session of the environment in action — tmux, NeoVim, lazygit, oh-my-posh, and a Claude Code agent, all in cyberdream. Press play to watch.

What's inside

  • Terminal

    Ghostty + Iosevka, zinit-managed Zsh, oh-my-posh prompt, tmux with auto-installed plugins, and a curated set of CLI tools.

  • NeoVim

    LazyVim with 12 language extras, custom plugins, auto-commands, and the cyberdream colourscheme.

  • Theme

    One palette, applied everywhere: nvim, oh-my-posh, ghostty, tmux, btop, lazygit, yazi, k9s, opencode, vivid, lsd, and Claude Code.

  • Git

    Sensible defaults, git-town aliases, GitHub OAuth + Forgejo auth, YubiKey SSH signing, and an include hook for a private overlay.

  • Scripts

    Fifteen small scripts covering tmux session management, resident security keys, Zscaler toggling, shell profiling, and more.

  • macOS + Claude Code

    System defaults, a homebrew-managed launch agent for ssh-agent, and a sandboxed, vim-mode Claude Code harness with a cyberdream theme.

Getting started

  1. Fork this repository — it's tuned for one person; expect breakage if you track upstream.
  2. Back up your existing dotfiles.
  3. Run ./install.sh to install Homebrew, apply macOS defaults, and stow the configs.
  4. Customize REPOS_DIR and add a private Git overlay if you need one.

Fork-first

This repository is primarily for personal use; breaking changes land without ceremony. Forking insulates you from those changes and lets you keep your own private overlay separately.

Build the docs locally

uv sync
uv run zensical serve   # http://localhost:8000

See Contributing for the full dev loop.