This is the base system that I put onto any machine on which I am developing. It includes config files for:
- aerospace (tiling window manager for macOS)
- i3 (tiling window manager for Linux)
- Xdefaults
- tmux (terminal multiplexer)
- zsh (shell)
- neovim (editor)
- powerline (status line for tmux)
- git (version control)
Colours are Solarized Dark slightly altered to make the dark background colours a little darker.
On Linux, unpackaged software is managed with ghq and includes:
On macOS, these tools are not needed as alternatives are available via Homebrew or the system.
Homebrew is used as the primary package manager on both macOS and Linux. Platform-specific Brewfiles define the packages for each system.
Other useful tools (installed via Homebrew):
- fzf (fuzzy finder)
- PathPicker (file selector)
- htop (better top)
- hosts (safe hosts file)
The zsh config uses zinit and the following plugins:
- zsh-completions (extra completions)
- zsh-autoenv (automatic env switching)
- git-prompt.zsh (git status in prompt)
- vi-mode.zsh (vi mode enhancements)
- zsh-fzf-history-search (fuzzy history search)
- fzf-tab (fzf for tab completion)
- zsh-autosuggestions (fish-like suggestions)
- fast-syntax-highlighting (syntax highlighting on command line)
- zsh-bd (jump back to parent directory)
The neovim config uses lazy.nvim and the following plugins:
Core & UI:
- catppuccin/nvim (colorscheme)
- nvim-web-devicons (file icons)
- lualine.nvim (status line)
- which-key.nvim (key binding help)
- nvim-navic (breadcrumbs)
LSP & Completion:
- nvim-lspconfig (LSP configuration)
- mason.nvim (LSP installer)
- blink.cmp (completion engine)
- nvim-lightbulb (code actions indicator)
- lsp-colors.nvim (LSP colors)
Treesitter:
- nvim-treesitter (syntax highlighting)
- nvim-treesitter-refactor (refactoring)
- nvim-treesitter-textobjects (text objects)
- nvim-treesitter-context (context)
- nvim-ts-autotag (auto close tags)
- nvim-ts-context-commentstring (context comments)
Fuzzy Finding & Navigation:
- telescope.nvim (fuzzy finder)
- telescope-fzf-native.nvim (fzf integration)
- telescope-frecency.nvim (frecency algorithm)
- telescope-ui-select.nvim (UI select)
- telescope-undo.nvim (undo tree)
- fzf-lua (fzf integration)
- smart-open.nvim (smart file opening)
Git:
- gitsigns.nvim (git signs)
- git-messenger.vim (git blame popup)
- git-conflict.nvim (conflict resolution)
- diffview.nvim (diff viewer)
- vim-gh-line (GitHub line links)
- vim-fugitive (git integration)
- gitlab.nvim (GitLab integration)
AI & Completion Sources:
- copilot.lua (GitHub Copilot)
- codeium.nvim (Codeium AI)
- supermaven-nvim (Supermaven AI)
- minuet-ai.nvim (Gemini AI)
- codecompanion.nvim (AI chat)
- avante.nvim (AI assistant)
- claudecode.nvim (Claude Code integration)
- nvim-aider (Aider AI assistant)
- mcphub.nvim (MCP integration)
Language Support:
- go.nvim (Go development)
- vim-perl (Perl support)
- vim-terraform (Terraform)
- vim-helm (Helm charts)
Testing & Debugging:
- neotest (testing framework)
- neotest-go (Go testing)
- nvim-dap (debug adapter protocol)
- nvim-dap-ui (debugging UI)
Linting & Formatting:
- nvim-lint (linting)
- ale (async linting)
- conform.nvim (formatting)
- nvim-rulebook (rule checking)
File Management:
- nvim-tree.lua (file tree)
- oil.nvim (file editing)
- yazi.nvim (file manager)
- outline.nvim (code outline)
Text Manipulation:
- nvim-surround (surround text)
- vim-easy-align (alignment)
- vim-move (move lines/blocks)
- nvim-comment (commenting)
- treesj (split/join code)
- refactoring.nvim (refactoring)
- nvim-spider (camelCase motion)
- nvim-various-textobjs (text objects)
UI Enhancements:
- nvim-highlight-colors (color highlighting)
- indent-blankline.nvim (indent guides)
- nvim-hlslens (search lens)
- nvim-scrollbar (scrollbar)
- hl_match_area.nvim (match highlighting)
- vim-interestingwords (word highlighting)
- SmoothCursor.nvim (smooth cursor)
- emission.nvim (change highlighting)
Utilities:
- snacks.nvim (utility collection)
- marks.nvim (marks management)
- vim-autoswap (swap file handling)
- vim-lastplace (restore cursor position)
- vim-startify (start screen)
- crazy8.nvim (utilities)
- lexima.vim (auto pairs)
- vim-repeat (repeat plugin actions)
- vim-gutentags (tag generation)
Quickfix & Search:
- nvim-bqf (better quickfix)
- nvim-pqf (pretty quickfix)
- replacer.nvim (search replace)
Markdown & Documentation:
- markdown-preview.nvim (markdown preview)
- render-markdown.nvim (markdown rendering)
- markview.nvim (markdown viewer)
- helpview.nvim (help viewer)
Miscellaneous:
- nvim-notify (notifications)
- nvim-lsp-notify (LSP notifications)
- dressing.nvim (UI improvements)
- overseer.nvim (task runner)
- sidebar.nvim (sidebar)
- urlview.nvim (URL viewer)
- translate.nvim (translation)
- ascii-blocks.nvim (ASCII art)
- vim-unicode-homoglyphs (unicode handling)