macOS Development Environment

Beautifully crafted
development environment.

A modern, opinionated dotfiles setup featuring Neovim, Wezterm, Starship, and a curated collection of developer tools. One command to get started.

Terminal
$
View on GitHub Get Started
SCROLL
🎋

Everything you need

A carefully curated development environment that just works.

Neovim

Neovim

Editor

Hyperextensible text editor with LSP, Treesitter, and 30+ plugins.

  • lazy.nvim
  • Mason LSP
  • Telescope
  • nvim-cmp
Wezterm

Wezterm

Terminal

GPU-accelerated terminal emulator with multiplexing and Lua config.

  • GPU Rendering
  • Multiplexer
  • Ligatures
  • Lua Config
Starship

Starship

Prompt

Minimal, blazing-fast, and infinitely customizable cross-shell prompt.

  • Git Status
  • Languages
  • Fast
  • Cross-shell
AeroSpace

AeroSpace

Window Manager

i3-like tiling window manager for macOS with keyboard-driven navigation.

  • Tiling
  • Workspaces
  • Vim Keys
  • i3 inspired
Atuin

Atuin

Shell History

Magical shell history with SQLite backend and cross-machine sync.

  • SQLite
  • Fuzzy Search
  • Sync
  • Statistics
GNU Stow

GNU Stow

Symlinks

Symlink farm manager for organizing and deploying dotfiles effortlessly.

  • Modular
  • Idempotent
  • Portable
  • Simple
🖥️

See it in action

Explore the different tools included in this dotfiles setup.

🧰

The complete toolkit

Every tool you need, carefully selected and configured.

eza
eza
ls replacement
bat
bat
cat replacement
ripgrep
ripgrep
grep replacement
zoxide
zoxide
cd replacement
fd
fd
find replacement
mise
mise
Runtime Manager
delta
git-delta
Better Diffs
difftastic
difftastic
Structural Diff
k9s
k9s
Kubernetes TUI
OrbStack
OrbStack
Docker & VM
Sol
Sol
Launcher
Helium Browser
Helium Browser
Chromium Fork
TablePlus
TablePlus
Database GUI
Shottr
Shottr
Screenshot
btop
btop
System Monitor
Claude Code
Claude Code
AI Coding Agent
llama.cpp
llama.cpp
Local LLM
typst
typst
Modern LaTeX
vhs
vhs
Terminal GIF

Up and running in minutes

One command to bootstrap your entire development environment.

1

Run the installer

This will install Homebrew, clone the dotfiles, and set everything up.

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/kiwamizamurai/dotfiles/refs/heads/main/install.sh)"
2

Restart your terminal

Close and reopen your terminal to load all the new configurations.

3

Launch Neovim

Plugins will auto-install on first launch. Wait for completion.

$ nvim
4

You're all set!

Press <Space> in Neovim to see all available commands via Which Key.

💡
Tip: Check out USAGE.md for detailed keybindings and plugin documentation.