fluffy-potato

Terminal config for macOS — Neovim · tmux · Hammerspoon

Quick start

git clone https://github.com/yourname/fluffy-potato.git ~/code/fluffy-potato
cd ~/code/fluffy-potato
bash install.sh

The script will symlink configs, install Node/Python formatter tools, and set up tpm. On first Neovim launch, lazy.nvim auto-installs all plugins.

Manual setup (if you prefer)

ln -s ~/code/fluffy-potato/nvim           ~/.config/nvim
ln -s ~/code/fluffy-potato/tmux/.tmux.conf       ~/.tmux.conf
ln -s ~/code/fluffy-potato/tmux/.tmux.conf.local  ~/.tmux.conf.local
ln -s ~/code/fluffy-potato/hammerspoon    ~/.hammerspoon

Dependencies

Tool	Install
Neovim 0.12+	brew install neovim
Universal Ctags	brew install universal-ctags (Tagbar)
StyLua	brew install stylua (Lua formatting)
tree-sitter CLI 0.26.1+	brew install tree-sitter-cli (Treesitter parsers)
ripgrep	brew install ripgrep (Telescope live grep)
prettier / eslint_d	npm i -g prettier prettier_d_slim eslint_d
black / autopep8	pip3 install black autopep8 (Python fmt)
tpm	auto-installed by install.sh
Nerd Font	auto-installed by install.sh (JetBrainsMono)

Neovim

After opening nvim, run :Mason to install LSP servers. Recommended: ts_ls, eslint, cssls, jsonls, lua_ls.

<leader> is Space. On macOS terminals, Alt mappings require Option to send Meta/Esc. ESLint diagnostics use the native LSP; ALE is disabled to avoid duplicate checks. Python formatting uses Black, or autopep8 if Black is unavailable.

Key bindings

Key	Action
<leader><space>	File tree
;f	Find files
;r	Live grep
\\	Buffers
;;	Help tags
<leader>xx / <leader>xw	Workspace diagnostics panel
<leader>xd	Current buffer diagnostics panel
K	Hover docs
gd	Go to definition
gh	LSP finder
<space>rn	Rename
<space>ca	Code action
[d / ]d	Previous/next diagnostic
<C-h/j/k/l>	Navigate Neovim/tmux panes
<M-h/j/k/l>	Move text (Alt/Option as Meta)
<M-y>	Accept Copilot suggestion (Tab stays with completion/snippets)
<leader>tp / <leader>tl	Previous/next tab
<leader>ww	Next window
<leader>f	Format with Conform
]c / [c	Prev/next git hunk
<leader>hs	Stage hunk
]x / [x	Prev/next git conflict

tmux

After launch: prefix + I to install plugins.

Hammerspoon

Copy and edit the example config:

cp ~/.hammerspoon/config-example.lua ~/.hammerspoon/config.lua