KEYBINDS.md

Dotfiles Keybinds & Aliases Reference

📖 Quick Navigation Window Management • Session Workflow • File Operations • Git Workflow • Development Tools • Search & Navigation • System Integration

Table of Contents

• Window Management - Window focus, movement, resizing (Aerospace + Tmux)
• Session Workflow - Tmux sessions, Sesh, Tmuxinator integration
• File Operations - File managers, directory navigation, listing
• Git Workflow - Git aliases and operations
• Development Tools - Docker, Kubernetes, Python, Claude
• Search & Navigation - FZF, Telescope, Zoxide integration
• System Integration - Hardware remapping, clipboard, system controls

---

Window Management

Aerospace Window Operations (PRIMARY)

Source: aerospace/.config/aerospace/aerospace.toml

Window Focus & Movement:

Keybind	Action	Description
Shift+Ctrl+h/j/k/l	Focus window	Move focus to left/down/up/right
Shift+Ctrl+Alt+h/j/k/l	Move window	Move window to left/down/up/right
Ctrl+Alt+h/j/k/l	Move inverted	Move window (inverted for correct direction)

Layout Management:

Keybind	Action	Description
Shift+Ctrl+e	Toggle float/tile	Toggle between floating and tiling
Shift+Ctrl+v	Toggle orientation	Toggle horizontal/vertical layout
Shift+Ctrl+t	Tiles layout	Switch to tiles layout
Shift+Ctrl+a	Accordion layout	Switch to accordion layout
Shift+Alt+t	Float toggle	Toggle floating/tiling
Shift+Ctrl+q	Float center	Float window and center
Shift+Ctrl+w	Fullscreen	Toggle fullscreen mode
Shift+Ctrl+r	Balance	Flatten workspace tree (reset layout)

Window Resizing:

Keybind	Action	Description
Ctrl+Alt+Cmd+j	Resize smaller	Make window smaller (smart, context-aware)
Ctrl+Alt+Cmd+k	Resize larger	Make window larger (smart, context-aware)

Workspace Navigation:

Keybind	Action	Description
Cmd+j/k/l/u/i/o	Focus workspace	Switch to workspace 1/2/3/4/5/6 (homerow)
Ctrl+Shift+1-9	Focus workspace 1-9	Switch to workspace by number
Shift+Ctrl+n/p	Next/prev workspace	Navigate to next/previous workspace

Move Window to Workspace:

Keybind	Action	Description
Shift+Alt+j/k/l/u/i/o	Move to workspace	Move window to workspace 1/2/3/4/5/6 (homerow)
Shift+Alt+1-9	Move to workspace	Move window to workspace by number
Shift+Alt+n/p	Move next/prev	Move window to next/previous workspace (wrap-around)

Display Management:

Keybind	Action	Description
Shift+Alt+s/g	Move display	Move window to previous/next monitor (wrap-around)

Service Mode (Shift+Alt+Cmd+r to enter):

Keybind	Action	Description
Esc	Reload & exit	Reload config and return to main mode
r	Reset layout	Flatten workspace tree and exit
f	Toggle float	Toggle floating/tiling and exit
Backspace	Close others	Close all windows except current and exit
Shift+Ctrl+Alt+h/j/k/l	Join pane	Join with left/down/up/right and exit

Tmux Pane & Window Navigation

Source: tmux/.tmux.conf

Keybind	Action	Description
C-a	Prefix	Tmux prefix key
C-a h/j/k/l	Focus pane	Select pane in direction
C-a C-h/C-j/C-k/C-l	Resize pane	Resize pane (repeatable)
C-a r	Reload config	Reload tmux configuration
C-a b	Toggle status	Toggle status bar visibility
C-a x	Kill pane	Close pane without confirmation
C-a N	New session	Create new named session
C-a R	Rename session	Rename current session
C-a X	Kill session	Kill current session (with confirmation)

Tmux Prefix-Free Alt Bindings (work anywhere in tmux)

Source: tmux/.tmux.conf

Keybind	Action	Description
M-1 through M-6	Select window	Direct window selection
M-s	Vertical split	Split window vertically
M-v	Horizontal split	Split window horizontally
M-c	New window	Create new window
M-x	Kill window	Close current window
M-e	Sesh switcher	FZF-powered session switcher
M-p	Last session	Switch to last session
M-[	Copy mode	Enter copy mode
M-Tab	Last window	Switch to last window
M-w	Zoom pane	Toggle pane zoom
M-r	Break pane	Break pane to new window
M-q	Detach	Detach from tmux server

---

Session Workflow

Tmux Session Management

Source: tmux/.tmux.conf

Keybind	Action	Description
C-a T	Session switcher	FZF-powered session switcher with sesh
C-a L	Last session	Switch to last session via sesh
C-a 9	Root session	Connect to session at current directory
C-a N	New session	Create new named session
C-a R	Rename session	Rename current session
C-a X	Kill session	Kill current session with confirmation
C-a M	Tmuxinator	Launch tmuxinator project with FZF

Sesh Aliases

Source: zsh/.zshrc

Alias	Command	Description
sl	sesh list -t -c -d	List sessions (compact, deduplicated)
sc	`sesh connect $(sesh list	fzf)`

Zsh Session Integration

Source: zsh/.zshrc

Keybind	Action	Description
M-e	Sesh sessions	FZF session switcher (from within tmux)

Ghostty Terminal Operations

Source: ghostty/.config/ghostty/config

Keybind	Action	Description
Cmd+Alt+U	Scroll page up	Scroll terminal output up by one page
Cmd+Alt+D	Scroll page down	Scroll terminal output down by one page
Cmd+Alt+h/j/k/l	Navigate splits	Move focus to left/down/up/right split
Cmd+Alt+Shift+h/j/k/l	Resize splits	Resize split in direction by 10
Cmd+/	Quick terminal	Toggle global quick terminal
Cmd+Shift+S	Secure input	Toggle secure input mode

---

File Operations

File Managers & Navigation

Source: zsh/.zshrc, Neovim configs

Alias/Function	Tool	Description
ls	eza -l --icons --git -a	Enhanced file listing
ll	eza --color=always --long --git --icons=always	Detailed file listing
lt	eza --tree --level=2 --long --icons --git	Tree view with details
ltree	eza --tree --level=2 --icons --git	Simple tree view
l	eza --color=always --long --git --no-filesize --icons=always --no-time --no-user --no-permissions	Clean file listing

Directory Navigation

Source: zsh/.zshrc

Alias/Function	Description
..	cd ..
...	cd ../..
....	cd ../../..
.....	cd ../../../..
......	cd ../../../../..
C	cd ~/Code/
conf	cd $HOME/dotfiles && nvim
no	Open Obsidian notes in nvim

FZF Navigation Functions

Source: zsh/.zshrc

Function	Description
fcd()	Fuzzy directory navigation with eza preview
f()	Yazi file manager with cd integration
fv()	Fuzzy file selection for nvim editing

---

Git Workflow

Git Aliases

Source: zsh/.zshrc

Alias	Command	Description
gc	git commit -m	Quick commit with message
gca	git commit -a -m	Commit all changes with message
gp	git push origin HEAD	Push current branch
gpu	git pull origin	Pull from origin
gs	git status	Git status
glog	git log --graph --topo-order --pretty=...	Enhanced git log
gdiff	git diff	Git diff
gco	git checkout	Checkout branch/commit
gb	git branch	List branches
gba	git branch -a	List all branches
gadd	git add	Add files
ga	git add -p	Interactive add
gcoall	git checkout -- .	Discard all changes
gr	git remote	Remote operations
gre	git reset	Reset operations

GitHub CLI

Source: zsh/.zshrc

Alias	Command	Description
ghl	gh repo list	List GitHub repositories

---

Development Tools

Docker Operations

Source: zsh/.zshrc

Alias	Command	Description
dock	open -a docker && while ! docker info...	Start Docker Desktop
dkill	killall "Docker Desktop" && sleep 1 && dock	Restart Docker
dco	docker compose	Docker Compose
dps	docker ps	List running containers
dpa	docker ps -a	List all containers
dl	docker ps -l -q	Latest container ID
dx	docker exec -it	Interactive container exec

Kubernetes

Source: zsh/.zshrc

Alias	Command	Description
k	kubectl	Kubectl shorthand
ka	kubectl apply -f	Apply configuration
kg	kubectl get	Get resources
kd	kubectl describe	Describe resources
kdel	kubectl delete	Delete resources
kgpo	kubectl get pod	Get pods
kgd	kubectl get deployments	Get deployments
kc	kubectx	Switch context
kns	kubens	Switch namespace
kl	kubectl logs -f	Follow logs
ke	kubectl exec -it	Interactive pod exec
kcns	kubectl config set-context --current --namespace	Set namespace

Python & Development

Source: zsh/.zshrc

Alias	Tool	Description
n	NVIM_APPNAME="nvim" nvim	Default Neovim
vim	nvim	Neovim alias
cl	clear	Clear terminal
ta	tmux attach -d	Attach to tmux

Claude Integration

Source: zsh/.zshrc

Alias	Command	Description
cc	claude --dangerously-skip-permissions	Claude CLI (unsafe mode)

HTTP & Networking

Source: zsh/.zshrc

Alias	Command	Description
http	xh	Modern HTTP client
nm	nmap -sC -sV -oN nmap	Nmap with scripts

Quality of Life & Utilities

Source: zsh/.zshrc

Alias	Command	Description
kr	sudo launchctl kickstart -k system/com.example.kanata	Restart Kanata
vv	FZF Neovim config selector	Switch between nvim configs
ao/ai/as	audio-output/audio-input/status	FZF audio device switching
speakers/monitor/mod-out	SwitchAudioSource shortcuts	Quick audio output switches
scarlett-in/mod-in	SwitchAudioSource shortcuts	Quick audio input switches
cl	clear	Clear terminal
ta	tmux attach -d	Attach to tmux
conf	cd $HOME/dotfiles && nvim	Open dotfiles config
note/notes/no	Open Obsidian notes	Quick note access

---

Search & Navigation

FZF Configuration

Source: zsh/.zshrc

Environment Variable	Value	Description
FZF_DEFAULT_COMMAND	fd --type f --hidden --follow	Use fd for file finding
FZF_ALT_C_OPTS	--preview 'eza --tree --color=always --icons --level=3 {} | head -200'	Directory preview
FZF_CTRL_T_OPTS	--preview 'bat -n --color=always --line-range :500 {}'	File preview

Zoxide Integration

Source: zsh/.zshrc

Tool	Description
z	Smart directory jumping (zoxide)

---

System Integration

Hardware Remapping - Kanata (Active)

Source: kanata/.config/kanata/kanata.kbd

Key	Tap	Hold	Description
Caps Lock	Escape	Left Control	Caps as Esc/Ctrl
a	a	Left Meta	Home row modifier
s	s	Left Alt	Home row modifier
d	d	Left Shift	Home row modifier
f	f	Left Control	Home row modifier
j	j	Right Control	Home row modifier
k	k	Right Shift	Home row modifier
l	l	Right Alt	Home row modifier
;	;	Right Meta	Home row modifier
Right Shift	Backspace	-	Quick delete
Tab	Tab	Hyper	Tab as Hyper key
'	'	Numbers Layer	Apostrophe / Numpad
/	/	-	Forward slash (normal)
Right Cmd	Toggle HRM	-	Switch base↔vanilla layers

Hardware Remapping - Karabiner Elements (Unconfigured)

Source: karabiner/.config/karabiner/karabiner.json

Karabiner-Elements is installed but has no active remappings (simple_modifications is empty). Kanata is the primary keyboard remapper.

Zsh Keybinds

Source: zsh/.zshrc

Keybind	Action	Description
^f	vi-forward-word	Forward word
^u	up-line-or-search	Up/search
^p	down-line-or-search	Down/search
jk	vi-cmd-mode	Enter vi command mode

SketchyBar Integration

Source: zsh/.zshrc

Function	Trigger	Description
brew()	Various brew commands	Notify SketchyBar on package changes

---

Related Documentation

• Neovim Keybinds - Comprehensive Neovim mappings
• Workflow Guides - Cross-tool integration workflows
• CLAUDE.md - Main dotfiles documentation

---

Quick Reference Card

Most Used Keybinds

Window Management:    Cmd+j/k/l/u/i/o (workspaces 1-6), Shift+Ctrl+hjkl (focus)
Sessions:            M-e (sesh switcher), M-p (last session), sc (fuzzy connect)
Files:               fcd (fuzzy cd), f (yazi), C-e (oil)
Git:                 gs (status), gc "msg" (commit), gp (push)
Development:         ta (tmux), n (nvim), dps (docker ps)
Audio:               ao (output), ai (input), as (status)

Integration Points

• Aerospace + Tmux: Window and session management with integrated keybindings
• Sesh + Tmux: Session management with enhanced workflow
• FZF + Multiple: Fuzzy finding across file, session, git operations
• Eza + Navigation: Enhanced listings in file operations

---

Author

cyperx - GitHub Profile

For issues or contributions, visit the dotfiles repository.