dotfiles/README.md

dotfiles

Personal dotfiles managed as a bare Git repository. The repo lives at ~/.dotgit/ with the work tree set to $HOME, so tracked files sit at their real paths without symlinks.

Bootstrap

# Clone bare repo
git clone --bare https://gitea.abra.me/svxf/dotfiles.git "$HOME/.dotgit"

# Checkout files into $HOME
git --git-dir="$HOME/.dotgit/" --work-tree="$HOME" checkout

# Hide untracked files from status noise
git --git-dir="$HOME/.dotgit/" --work-tree="$HOME" config status.showUntrackedFiles no

After checkout, restart your shell. Zinit and Starship will self-install on first launch.

Usage

The .g alias wraps git --git-dir=$HOME/.dotgit/ --work-tree=$HOME, so everyday operations look like:

.g status
.g add ~/.vimrc
.g commit -m "update vimrc"
.g push

A background job in .zshrc auto-pulls once per day (~/.cache/.dotfiles-pull marker).

File summaries

.zshrc

Shell configuration and the main entry point.

• Plugin manager: Zinit (auto-installed from zdharma-continuum/zinit). Plugins: zsh-autosuggestions, zsh-syntax-highlighting, zsh-completions, zsh-history-substring-search.
• History: 100k entries, shared across sessions, deduped, extended format.
• Completions: Case-insensitive matching, menu selection.
• Keybindings: Emacs mode. Ctrl+Q push-line, Alt+E / Ctrl+X,E edit-command-line, Up/Down prefix search.
• Prompt: Starship (installed via Zinit from GitHub releases).
• fzf integration: Keybindings and completion sourced when available; --height 40% --reverse default opts.
• PATH: /projects/bin, ~/.local/bin, ~/.cargo/bin, /usr/local/go/bin, ~/go/bin, /opt/homebrew/bin.
• Aliases:
  • .g — bare-repo git wrapper
  • tmuxr / tmuxn / tmuxa — tmux attach-or-create helpers
  • ,dcdu / ,dcdd / ,dcdl — docker-compose dev-profile shortcuts
  • dcu / dcd / dcl — generic docker-compose shortcuts
  • c / ,cd — Claude CLI / Claude with sandbox skip
  • LATEST — global alias expanding to most-recently-modified file
• Functions:
  • y — yazi file manager wrapper that cds to the selected directory on exit
  • pj — fuzzy project switcher (searches /projects and ~/projects via fzf)
  • clip — pipe stdin to system clipboard via OSC 52 escape sequence
  • mkcd — mkdir + cd in one step
  • cdtmp — create and cd into a timestamped temp directory under ~/tmp/
• Extras: ~/.zshrc-extra sourced at end for machine-local overrides (not tracked).

.tmux.conf

• Mouse enabled, clipboard passthrough on.
• Splits preserve current path.
• Navigation: Shift+Arrow switches windows (no wrap), Alt+Arrow switches panes, PgUp/PgDn swaps window order.
• Window naming: Auto-rename to command@dir.
• Fuzzy switcher: prefix + f opens fzf popup to pick a window.
• Status bar: Dark theme (colour235 bg), green session indicator, powerline-style window tabs with alternating shading, no right-side status.
• Pane borders: Green active, grey inactive.
• Base index: 1 (not 0).

.vimrc

• jk mapped to Escape, Space as leader.
• 4-space soft tabs, syntax on, cursor line highlighted.
• Persistent undo (~/.vim/undo/), swap and backup dirs under ~/.vim/.
• Smart case search, incremental + highlighted.
• Arrow keys disabled in normal mode (forces hjkl).
• Mouse support enabled, 8-line scroll margin.

.starship.toml

Two-line prompt:

• Line 1 (left → right): Docker container indicator (if inside), docker-compose service summary (running/stopped counts), git branch + status, fill, directory.
• Line 2: ➤ character (green on success, red on error).
• Right prompt: Command duration (>5s), user@host, time.
• Docker-compose status uses docker compose ps --format json | jq to show ▲N/▼N counts.

.gitignore_global

Ignores: *~, .DS_Store, .idea, .ipynb_checkpoints, __pycache__.