🌿 dotfiles

My personal development environment. Built by hand, maintained over time.

⚠️ Warning: Breaking changes may occur. I'll stop when I get bored.

🏡 This Is a Garden

There are two kinds of development environments: the ones given to you, and the ones you grow.

Using someone else's defaults is easy. Everyone installs the same editor with the same extensions, pressing the same keybindings. It might be efficient — but it's fundamentally different from choosing your own tools, sharpening them, and arranging them yourself. Installing something convenient and consuming it is not the same as composing your own environment with your own hands. What stays with you afterward is completely different.

Writing dotfiles means building your own workspace from the ground up. 🛠️

A garden never turns out exactly as planned. What you plant doesn't always grow the way you expect, and sometimes things take root on their own. Dotfiles are the same way. Neovim keymaps settle into muscle memory over years, while AI integration configs get rewritten monthly. Fish abbreviations need time before your fingers learn them, and sometimes — like migrating to Ghostty — you have to tear up the soil entirely. Multiple timelines overlap in a single place, and you can't control all of them at once.

And that's fine. 🌱

A perfectly managed environment is, by definition, someone else's managed environment. It becomes your place precisely because it contains parts you can't fully tame. Deciding whether to pull the weeds or let them stay — that's part of tending it with your own hands. What you build up over time like that becomes the foundation of who you are as someone who writes code.

If all you want is efficiency, off-the-shelf is fine. But if you want to leave traces of how you think and how you move your hands — you have no choice but to keep a garden. 🪴

📁 Structure

dotfiles/
# 🟢 Active (2026)
├── fish/           # 🐟 Fish shell
├── nvim/           # ✏️  Neovim (LazyVim)
├── ghostty/        # 👻 Ghostty terminal
├── starship/       # 🚀 Prompt
├── git/            # 📝 Git scripts
│
# 📦 Archive (kept for reference, all under archive/)
├── archive/
│   ├── warp/       # Warp terminal → migrated to Ghostty
│   ├── bash/       # Bash → migrated to Fish
│   ├── zsh/        # Zsh → migrated to Fish
│   ├── vim/        # Vim → migrated to Neovim
│   ├── tmux/       # tmux → migrated to Ghostty splits
│   ├── lvim/       # LunarVim → migrated to LazyVim
│   ├── nvchad/     # NvChad → migrated to LazyVim
│   ├── nvchad-v2.5/# NvChad v2.5 (2026-03まで使用)
│   ├── dockerfile/ # Dockerfile examples
│   └── ssh/        # SSH config examples

⚡ Setup

# Tools
brew install fish neovim starship ghostty
brew install eza bat ripgrep fd fzf zoxide ghq direnv delta lazygit mise atuin

# Symlinks
ln -sf ~/ghq/github.com/nwiizo/dotfiles/fish/config.fish ~/.config/fish/config.fish
ln -sf ~/ghq/github.com/nwiizo/dotfiles/nvim ~/.config/nvim
ln -sf ~/ghq/github.com/nwiizo/dotfiles/starship/starship.toml ~/.config/starship.toml
mkdir -p ~/.config/ghostty && ln -sf ~/ghq/github.com/nwiizo/dotfiles/ghostty/config ~/.config/ghostty/config

---

🐟 Fish Shell

⌨️ Keybindings

Key	Action
Ctrl+G	Select ghq repository (fzf)
Ctrl+R	History search (atuin)
Ctrl+F	File search (fzf)
Ctrl+B	Git branch selection (fzf)
Ctrl+L	Clear screen
Tab	History completion on empty cmdline

🔤 Abbreviations

# Git
g=git  gst=status  gaa=add --all  gc=commit -v  gcm=commit -m
gco=checkout  gcb=checkout -b  gp=push  gpl=pull  gd=diff  gl=log
gf=commit --amend --no-edit

# Docker / Kubernetes
d=docker  dc=docker compose  dcu=up  dcd=down  dps=ps
k=kubectl  kgp=get pods  kgs=get svc  kgd=get deploy  kctx=config use-context  kns=config set-context --current --namespace

# fzf shortcuts
ff=fzf  fgl=git log (fzf)  fgs=git stash (fzf)  fp=process (fzf)
fv=nvim (fzf)  fh=history (fzf)  gb=git branch (fzf)

# Tools
v=nvim  lg=lazygit  c=claude

🧰 Utility Commands

update_all            # Update everything: brew + mise + rustup + uv + Fisher + nvim plugins
mkcd <dir>            # mkdir + cd
port 8080             # Check process using port
z <substring>         # zoxide jump

🔄 Modern CLI Replacements

Legacy	Replacement	Notes
ls	eza	ll (detailed+Git), la (hidden), lt (tree)
cat	bat	Syntax highlighting
grep	ripgrep	-t rust "fn", -C 3 "error"
find	fd	fd "*.rs", fd -t d config
cd	zoxide	z <path> (learning)
history	atuin	Search with Ctrl+R
git diff	delta	Auto (GIT_PAGER=delta)

---

👻 Ghostty Terminal

🪟 Panes

Key	Action
Cmd+D	Split right
Cmd+Shift+D	Split down
Ctrl+H/J/K/L	Navigate panes (Vim-style)
Cmd+W	Close pane
Cmd+Shift+Return	Toggle zoom

📑 Tabs & Windows

Key	Action
Cmd+T	New tab
Cmd+N	New window
Cmd+Shift+] / [	Switch tabs

📜 Scrolling

Key	Action
Ctrl+U	Half page up
Alt+B	Full page up
Alt+G	Scroll to top
Alt+Shift+G	Scroll to bottom
Ctrl+Shift+Up/Down	Jump between prompts
Cmd+Shift+Space	Quick terminal

Config: Hack Nerd Font Mono 24pt / Tokyo Night / Bar cursor 🎨

---

✏️ Neovim

LazyVim base. Minimal UI with no statusline (cmdheight=0, incline.nvim for floating buffer names). catppuccin mocha + blink.cmp.

🔧 Basics

Key	Action
;	: (command mode)
jk	<Esc>
<C-s>	Save
<C-d>/<C-u>	Half-page scroll + center
<C-h/j/k/l>	Window navigation
<S-h>/<S-l>	Buffer navigation
<leader>x	Close buffer

🔍 Search & Navigation (Snacks.nvim = primary, Telescope = secondary)

Key	Action
<leader><leader>	Smart picker (files/buffers/recent)
<leader>sf	Find files
<leader>sg	Grep search
<leader>sw	Grep word under cursor
<leader>sb	Buffer list
<leader>sc	Command search
<leader>ss	LSP symbols
<leader>sr	Recent files
<leader>sh	Help pages
<leader>sk	Keymaps
<leader>sd	Diagnostics
<leader>sR	Resume last picker
<leader>tt	Toggle terminal
<C-p> / <leader>ff	Telescope find files
<leader>fg	Telescope grep
- / <leader>e	Oil.nvim (file manager)
s	Flash.nvim (jump)

🔭 Code Peek (overlook.nvim)

Key	Action
<leader>pd	Peek definition
<leader>pc	Close all popups
<leader>pu / <leader>pU	Restore last / all popups
<leader>pf	Toggle focus
<leader>ps / <leader>pv	Open in split / vsplit
<leader>po	Open in original

🧠 LSP

Key	Action
gd / gD	Definition / Declaration
gi / gr	Implementation / References
K	Hover info
<leader>rn	Rename
<leader>ca	Code action
<leader>fm / <leader>bf	Format
<leader>lk	Signature help
<leader>lD	Type definition
<leader>lwa/lwr/lwl	Workspace folder add/remove/list
[d / ]d	Navigate diagnostics
<leader>ld	Show diagnostic (float)

Languages: Rust (rustaceanvim), Go (gopls, golangci-lint), Python (pylsp), Lua (lua_ls), Terraform (terraformls), Bash (bashls), Zig (zls), HTML/CSS

🌿 Git

Key	Action
<leader>gg	LazyGit
<leader>gl	Git log
<leader>gf	LazyGit file log
<leader>gd	Diffview (working tree)
<leader>gD	Diffview (vs previous commit)
<leader>gm / <leader>gM	Diffview vs main / master
<leader>gs	Diffview (staged changes)
<leader>gh / <leader>gH	File / Branch history
<leader>gt	Toggle file panel
<leader>gp	Hunk preview
<leader>gb / <leader>gB	Blame / Toggle blame
<leader>hs / <leader>hr / <leader>hu	Stage / Reset / Undo stage hunk
]c / [c	Hunk navigation

🚨 Diagnostics (Trouble.nvim)

Key	Action
<leader>xx	All diagnostics
<leader>xX	Buffer diagnostics
<leader>xs	Document symbols
<leader>xl	LSP definitions
<leader>xq	Quickfix (Trouble)
<leader>xt	TODO list
<leader>sT	Search TODOs (Telescope)
]t / [t	TODO navigation

🦀 Rust (rustaceanvim)

Key	Action
<leader>ra	Code action
<leader>rr / <leader>rR	Run / Re-run
<leader>rt / <leader>rT	Test / Re-test
<leader>rd	Debuggables
<leader>rm	Expand macro
<leader>rc	Open Cargo.toml
<leader>rp	Parent module
<leader>rj	Join lines
<leader>rs	Structural search replace
<leader>re	Explain error
<leader>rD	Render diagnostic
<leader>rv / <leader>rV	View HIR / MIR
K	Rust hover actions (override)
J	Rust join lines (override)

📦 Crates (crates.nvim, in Cargo.toml)

Key	Action
<leader>ct	Toggle crates
<leader>cr	Reload
<leader>cv	Show versions
<leader>cf	Show features
<leader>cd	Show dependencies
<leader>cu / <leader>cU	Update / Upgrade crate
<leader>cA	Upgrade all crates
<leader>cH / <leader>cR	Open homepage / repository
<leader>cD / <leader>cC	Open docs.rs / crates.io

🐛 Debug (DAP)

Key	Action
<leader>db	Toggle breakpoint
<leader>dB	Conditional breakpoint
<leader>dc	Continue
<leader>dC	Run to cursor
<leader>di / <leader>do / <leader>dO	Step in / out / over
<leader>dp	Pause
<leader>dt	Terminate
<leader>dr	Toggle REPL
<leader>ds	Session
<leader>du	Toggle DAP UI
<leader>de	Eval expression

🧪 Test (neotest)

Key	Action
<leader>Tr	Run nearest test
<leader>Tf	Run file tests
<leader>Td	Debug nearest test
<leader>Ts	Toggle test summary
<leader>To	Show test output
<leader>Tp	Toggle output panel
[T / ]T	Navigate failed tests

🤖 AI

CopilotChat:

Key	Action
<leader>ao	Open chat
<leader>aq	Close chat
<leader>ar	Reset chat
<leader>ae / <leader>af	Explain / Fix
<leader>at / <leader>ad	Generate tests / Docs
<leader>aR	Code review

Avante:

Key	Action
<leader>aa	Ask
<leader>ax	Edit
<leader>aS	Refresh response

Claude Code:

Key	Action
<leader>cc	Toggle
<leader>cf	Focus
<leader>cr	Resume session
<leader>cC	Continue conversation
<leader>cm	Select model
<leader>cb	Add current buffer
<leader>cs	Send to Claude (visual)
<leader>ca / <leader>cD	Accept / Deny diff

💬 Completion (nvim-cmp)

Priority: Copilot (1000) > LSP (900) > Snippet (800) > Buffer (500) > Path (400)

Key	Action
<C-Space>	Open completion
<Tab>/<S-Tab>	Select
<CR>	Confirm
<C-e>	Cancel

---

🔧 Troubleshooting

# Fish
exec fish                              # Reload
fish --profile-startup /tmp/fish.prof -c exit  # Profile startup

# Neovim
nvim --startuptime /tmp/nvim.log       # Profile startup

:Lazy sync            " Sync plugins
:Mason                " LSP/tool manager
:checkhealth          " Run diagnostics
:LspInfo              " Check LSP status

🎨 Customization

# Fish local config (gitignored)
~/.config/fish/local.fish

-- Add plugins: nvim/lua/plugins/init.lua
-- Add keymaps: nvim/lua/mappings.lua