README.md

   1 # dotfiles
   2
   3 Personal configuration for Bash, tmux, Vim, Neovim, C/C++ tooling, and X11. Configuration paths mirror their intended locations relative to `$HOME`. This repository has no installer.
   4
   5 ## Contents
   6
   7 - `.bashrc`, `.tmux.conf`: shell and terminal multiplexer settings.
   8 - `.config/mise/config.toml`: optional versions for selected interactive tools.
   9 - `.vimrc`, `.config/nvim/`: separate Vim and Neovim configurations.
  10 - `.clang-format`, `.config/clangd/`, `.ycm_extra_conf.py`: C/C++ tooling.
  11 - `.xinitrc`, `.config/x11/`: X11 startup, resources, and key bindings.
  12
  13 ## Use
  14
  15 Link or copy the relevant files into place, or merge them with existing settings. Editor plugins and external commands generally require separate installation. Review hard-coded paths, display settings, and other machine-specific assumptions before use, then test the affected tools.
  16
  17 To install the tools listed in `.config/mise/config.toml`, [install mise](https://mise.jdx.dev/getting-started.html), link or copy the file to `$HOME/.config/mise/config.toml`, then run `mise install` from `$HOME`. Use `mise upgrade` to update them.
  18
  19 Neovim installs its parser baseline asynchronously; reopen the buffer after installation. Use `:TSInstall <language>` for additional parsers and `:TSUpdate` after plugin updates. Installation requires tree-sitter CLI, a C compiler, curl, and tar.