macOS setup · terminal workflow · measured performance

dot-files

My working setup for Ghostty, zsh, Bash, Vim, tmux, Git, and repeatable machine configuration. Small tools, explicit trade-offs, and checks I can rerun.

  1. Native tabs and splits, macOS integration, a quick terminal, and rz snapshots that recover working directories, geometry, Codex conversation IDs, and optional scrollback.
  2. Stage, diff, blame, browse history, and write Git objects without leaving Vim.
  3. The commands and keys for navigating the repository through fzf and ripgrep.
  4. Inline blame and log search commands for tracing where a line came from.
  5. Automatic golden-ratio resizing for multi-window Vim layouts.
  6. What each status-line segment shows and how the current theme is configured.
  7. Open, navigate, re-root, and manage files from the tree sidebar.
  8. Insert-mode completion for keywords, paths, language-aware sources, and tags.
  9. Repeatable alignment for assignments, hashes, lists, and Markdown tables.
  10. Comment lines, selections, paragraphs, and text objects using normal Vim motions.
  11. Automatic endings for Ruby, shell, Vim script, Lua, Elixir, and similar languages.
  12. Navigate, preview, stage, undo, and inspect changes from the sign column.
  13. Extend Vim's dot command to surround, commentary, and other plugin mappings.
  14. Browse files, selected lines, commits, and branches through fugitive.
  15. Keep fuzzy search, ripgrep, and Git commands anchored to the current project.
  16. Practical key sequences for quotes, brackets, parentheses, and HTML tags.

Configuration source

The articles explain the workflow. These links go directly to the files that implement it.

  • .vim/Vim plugins and local extensions
  • .zshrcShell navigation and command-line tools
  • .tmux.confRemote and persistent terminal sessions
  • bootstrap/Installation, validation, backups, and environment checks

Start with inspection

Clone the repository, run the read-only checks, and only then link the configuration into the home directory.

git clone git@github.com:marianposaceanu/dot-files.git ~/dot-files
cd ~/dot-files
./bootstrap/doctor.sh
./bootstrap/check_configs.sh
./bootstrap/link_configs.sh
Before linking Review the repository and the check output. The linker backs up existing configuration files before installing symlinks.