commit 892f3f24187d4457009b5234b3b28506894b0a60
Author: sam rolfe <samuelrolfe@gmail.com>
Date:   Sun Feb 1 11:39:23 2026 +1100

    Add setup.md

diff --git a/setup.md b/setup.md
new file mode 100644
index 0000000..1c2dd34
--- /dev/null
+++ b/setup.md
@@ -0,0 +1,59 @@
+
+# My Linux Environment Setup
+
+## 1. Core Command-Line Applications
+
+These are the underlying programs installed on the system.
+
+- **eza**: Modern `ls` replacement.
+- **bat** (`batcat`): Modern `cat` replacement with syntax highlighting.
+- **ripgrep** (`rg`): Fast `grep` replacement.
+- **fzf**: Fuzzy finder for files (`Ctrl+T`) and directories (`Alt+C`).
+- **zoxide** (`z`): "Smarter `cd`" command.
+- **atuin**: Advanced, searchable shell history (`Ctrl+R`).
+- **carapace**: Rich, IDE-style command completions.
+- **tealdeer** (`tldr`): Simplified man pages.
+- **navi**: Interactive cheatsheet tool.
+- **zellij**: Terminal multiplexer for splitting windows.
+- **lazygit**: A TUI for managing Git.
+- **btop**: Resource monitor.
+- **dua-cli** (`dua`): Interactive disk usage analyzer.
+- **yazi**: Terminal file manager.
+- **xclip**: System clipboard integration.
+- **jq**: Command-line JSON processor.
+- **pandoc**: Universal document converter.
+
+## 2. Shell Environments
+
+### Zsh (for Kitty)
+
+- **Framework**: Oh My Zsh
+- **Prompt**: Powerlevel10k
+- **Main Config**: `~/.zshrc`
+- **Key Integrations**: `zsh-autosuggestions`, `zsh-syntax-highlighting`, and hooks for all core tools.
+
+
+## 3. Neovim Configuration
+
+- **Config Directory**: `~/.config/nvim/`
+- **Package Manager**: `lazy.nvim`
+
+### Key Plugins Installed
+
+- **Core Functionality**:
+  - `nvim-lspconfig` & `mason.nvim`: Language Server support.
+  - `nvim-cmp`: Autocompletion.
+  - `telescope.nvim`: Fuzzy finding.
+  - `nvim-treesitter`: Advanced syntax highlighting.
+  - `nvim-lint`: Code quality analysis.
+  - `nvim-dap` & `nvim-dap-ui`: Integrated debugging.
+- **UI & Experience**:
+  - `gitsigns.nvim`: Git status markers.
+  - `lualine.nvim`: Configurable status line.
+  - `which-key.nvim`: Keybinding popup.
+- **Quality of Life**:
+  - `Comment.nvim`: Universal comment toggling.
+  - `nvim-autopairs`: Automatic bracket closing.
+- **Themes & Switching**:
+  - `catppuccin`, `tokyonight`, `gruvbox`, `dracula`, `kanagawa`, `everforest`, `onedark`.
+  - `andrewberty/telescope-themes`: Telescope extension for theme switching.