Setting up a new laptop from scratch can be an incredibly time-consuming and tedious process. Installing all your favorite tools, configuring your environment, tweaking settings to your preferences, and ensuring everything works together seamlessly often takes hours or even days. Even worse, you have to repeat this painful process every time you get a new machine or need to restore your system.
This is where Nix Darwin comes to the rescue. My motivation for adopting Nix Darwin is simple: eliminate the repetitive burden of manual system configuration. With Nix, I can define my entire system setup in code once, and then deploy it consistently across all my devices. Whether I'm setting up a new MacBook or recovering from a system failure, I can have my perfect development environment up and running in minutes, not hours. One configuration to rule them all.
Nix is a powerful package manager and system configuration tool that takes a unique approach to software management. Unlike traditional package managers, Nix treats packages as immutable building blocks and uses a functional approach to system configuration.
- Reproducibility: Your system configuration produces the same results every time, eliminating "works on my machine" problems.
- Declarative Configuration: Declare what your system should look like in configuration files, and Nix handles the rest.
- Atomic Updates and Rollbacks: System changes either fully succeed or fail. Roll back to previous configurations instantly if needed.
- Isolation: Packages are installed in isolation, preventing dependency conflicts. Multiple versions can coexist peacefully.
- Cross-Machine Consistency: Use the same configuration across multiple machines for identical setups everywhere.
By leveraging Nix Darwin for macOS, I get all these benefits while maintaining a native Mac experience.
All the following applications are managed via home-manager and will be configured automatically on rebuild.
| Application | Description |
|---|---|
| Zsh + Oh My Zsh | Shell with git and fzf plugins |
| Starship | Cross-shell prompt |
| Kitty | GPU-accelerated terminal |
| Ghostty | Fast terminal emulator |
| Application | Description |
|---|---|
| Neovim (LazyVim) | Text editor with LazyVim config |
| Git | Version control |
| Lazygit | Terminal UI for Git |
| tmux | Terminal multiplexer |
| Zed | Modern, high-performance code editor |
Sourced from numtide/llm-agents.nix and oraios/serena flake inputs (see modules/llm-agents/default.nix).
| Application | Description |
|---|---|
| Claude Code | Agentic coding tool from Anthropic |
| OpenCode | AI coding assistant |
| Beads | Issue/task tracker for AI coding agents |
| RTK | Rust Token Killer — token-optimizing CLI proxy |
| Serena | MCP server for semantic code navigation |
| Application | Description |
|---|---|
| bat | cat clone with syntax highlighting |
| btop | Resource monitor |
| eza | Modern ls replacement |
| fzf | Fuzzy finder |
| yazi | Terminal file manager |
| zoxide | Smarter cd with frecency-based navigation |
| gh | GitHub CLI |
| gh-dash | GitHub dashboard in terminal |
| presenterm | Terminal slideshow presentation tool |
| Application | Description |
|---|---|
| Aerospace | Tiling window manager |
| Sketchybar | Custom menu bar |
| JankyBorders | Rounded colored borders for focused windows |
New to Nix? No problem! While this repository is ready to use, having a basic understanding of how Nix works will help you customize it to fit your needs. The learning curve might seem steep at first, but trust me, it's worth every minute you invest. I highly recommend starting with these excellent introductory resources to get yourself familiar with the core concepts:
- Install nix
sh <(curl --proto '=https' --tlsv1.2 -L https://nixos.org/nix/install)
- Clone this repository
# ensure you're in home dir
git clone https://github.com/derangga/dotfiles.git nix
- Add your username and hostname inside
flake.nix
{
darwinConfigurations."maclop" = mkDarwinConfig {
hostname = "maclop";
username = "derangga";
};
# Add your hostname here, you can check by run whoami
darwinConfigurations."foo" = mkDarwinConfig {
hostname = "foo";
username = "foobar";
};
}
- Add a new file inside
./modules/hosts/{your_username}.nix
{
pkgs,
hostname,
...
}:
{
home.packages = with pkgs; [ ];
programs.zsh = {
enable = true;
enableCompletion = true;
autosuggestion.enable = true;
oh-my-zsh.enable = true;
shellAliases = {
drb = "sudo darwin-rebuild switch --flake ~/nix#${hostname}";
ngc = "nix-collect-garbage -d";
};
initContent = ''
export EDITOR=nvim
'';
};
}
- Now you can build it. Since this is a first time you can't use the alias yet
sudo darwin-rebuild switch --flake ~/nix#foo
Agentic tooling (Claude Code, OpenCode, Beads, RTK, Serena) is declared in modules/llm-agents/default.nix and installed automatically on rebuild via the llm-agents.nix and serena flake inputs.
To register Serena as an MCP server in Claude Code for semantic code navigation, run one of the following from inside the target project:
# Per-project (current repo only)
claude mcp add serena -- serena start-mcp-server --context claude-code --project "$(pwd)"
# Global (available in any project)
claude mcp add --scope user serena -- serena start-mcp-server --context claude-code --project-from-cwd
See the Serena docs for additional tips (system prompt override, hooks) to keep agents from drifting away from Serena's tools in long sessions.
This project is licensed under the MIT License - see the LICENSE file for details.