~/.dotfiles

---

Quick Start

# Clone
git clone git@github.com:vedntp/dotfiles.git ~/.dotfiles

# Deploy
cd ~/.dotfiles
stow mac

# Ubuntu server terminal
scripts/provision-server-terminal.sh

What's Inside

Tool	Path	Purpose	Docs
aerospace	mac	Tiling window manager	CLAUDE.md
nvim	mac	Neovim with lazy.nvim	CLAUDE.md
doom	mac	Doom Emacs, GTD, org-roam, gptel	CLAUDE.md
tmux	mac	Terminal multiplexer	CLAUDE.md
zsh	mac	Shell, Oh My Zsh, p10k	CLAUDE.md
ghostty	mac	Terminal emulator	CLAUDE.md
herdr	mac	Agent terminal workspace manager	-
ranger	mac	File manager	-
bat	mac	Cat clone with syntax highlighting	-
btop	mac	System monitor	-
server terminal	server	Ubuntu zsh, P10K, Neovim, Ranger, bat, btop, tmux	setup

Structure

~/.dotfiles/
|-- mac/                    # Active Stow package
|   |-- .zshrc              # Shell config
|   |-- .p10k.zsh           # Powerlevel10k prompt
|   |-- .gitconfig          # Git config
|   |-- .fzf.zsh            # FZF shell integration
|   |-- .taskrc             # Taskwarrior config
|   |-- .local/bin/         # Helper scripts and background watchers
|   |-- Library/LaunchAgents/ # Per-user background services
|   `-- .config/
|       |-- aerospace/      # Tiling window manager
|       |-- ghostty/        # Terminal emulator
|       |-- herdr/          # Agent terminal workspace manager
|       |-- alacritty/      # Alternate terminal config
|       |-- linearmouse/    # Mouse settings
|       |-- nvim/           # Neovim + lazy.nvim plugins
|       |-- tmux/           # tmux + TPM
|       |-- doom/           # Doom Emacs
|       |-- zsh/            # zsh docs and local overrides
|       |-- git/            # Git ignore and local credential helper
|       |-- ranger/         # File manager
|       |-- bat/            # Syntax highlighting
|       |-- btop/           # System monitor
|       `-- neofetch/       # System info
|-- archive/
|   `-- linux/              # Inactive Linux package kept for reference
|-- server/                 # Ubuntu server terminal package
|-- scripts/
|   `-- provision-server-terminal.sh
|-- docs/
|-- CLAUDE.md
|-- AGENTS.md
`-- README.md

Key Features

• Two focused packages - mac for the Mac and server for Ubuntu servers
• Vim-centric - Evil mode in Emacs, vim keybinds everywhere
• Keyboard-driven - AeroSpace WM, tmux, minimal mouse usage
• Terminal workflow - Ghostty is native/minimal; tmux remains available for multiplexing
• Spokenly dictation - MacBook and Ducky use Spokenly's direct Right Option shortcut; the MX Master thumb button toggles Spokenly through its helper app
• Three Finger Switcher - One local recognizer arbitrates three-finger input: taps toggle Spokenly after release, right swipes open the app switcher with two-finger scrubbing, and left swipes route one context-aware line-clear shortcut

Notes

• Spokenly transcription profile
• Custom Logitech, BetterTouchTool, and transcription shortcut reference
• MX Master 3S, Logitech Options+, and Spokenly setup
• BetterTouchTool gesture setup
• Native Three Finger Switcher
• Ducky One 2 macOS setup
• AirPods smart-routing banner investigation

Portable color defaults

Terminal emulators use their default palettes. macOS Powerlevel10k uses a compact one-line Lean prompt, while the server keeps the upstream rainbow layout. tmux inherits terminal colors, Ranger uses its bundled default, Bat uses ansi, Neovim uses Kanagawa Wave, and Doom Emacs inherits Doom One.

---

_{Managed with GNU Stow}