nicknisi/dotfiles

What is it?

Key features

• 01Mise-driven bootstrap installs packages, apps, runtimes, and tools from one manifest.
• 02Neovim configured with lazy.nvim and Tokyo Night theme.
• 03tmux with custom prefix, pane navigation, and Fleet agent integration.
• 04zsh and Starship prompt with fzf, zoxide, and several plugins.
• 05AeroSpace and SketchyBar window and workspace management on macOS.
• 06Ubuntu devcontainer runs the same bootstrap for portable testing.

Use cases

• Setting up a new Apple Silicon Mac with a reproducible developer environment.
• Studying a real-world Neovim, tmux, and zsh configuration as a reference.
• Testing terminal configuration changes in an Ubuntu container without touching the host.
• Forking as a starting point for a personal dotfiles setup after adjusting paths.

Quick start

1. 1

   Run the official install script from the README on a Mac (review it first, since it is piped to bash)

2. 2

   Open a new login shell and configure the machine-local Git identity

   mise run setup-git

Things to know

• !Built for Apple Silicon macOS with Homebrew under /opt/homebrew; it is not a generic starter kit.
• !The setup expects the repository at ~/Developer/dotfiles and a working GitHub SSH key for additional repositories.
• !Many tools and personal settings are the author's own choices, so they must be reviewed before use.

In collections

Topics

FAQ

What is dotfiles?

Personal macOS and Linux dotfiles managing zsh, tmux, Neovim, Ghostty, and a Mise-driven bootstrap for a full dev environment. This is a personal dotfiles repository that configures a full development environment on Apple Silicon macOS. A Mise manifest drives the bootstrap: it installs Homebrew packages, macOS apps, runtimes such as Node.js and Python, and command-line tools, clones companion repositories, and symlinks configuration into the home directory.

Is dotfiles free to use? What license does it have?

dotfiles is open source under the MIT license. Check the license terms before using it in commercial products.

Is dotfiles still maintained?

Actively maintained. The last commit to dotfiles was on Nov 4, 2026.

What can I use dotfiles for?

Setting up a new Apple Silicon Mac with a reproducible developer environment. Studying a real-world Neovim, tmux, and zsh configuration as a reference. Testing terminal configuration changes in an Ubuntu container without touching the host. Forking as a starting point for a personal dotfiles setup after adjusting paths.

How do I install dotfiles?

Run the official install script from the README on a Mac (review it first, since it is piped to bash) Open a new login shell and configure the machine-local Git identity: mise run setup-git

Where can I get dotfiles?

The source code and installation instructions are on GitHub: https://github.com/nicknisi/dotfiles