nix-ai

Ever spent hours configuring Claude Code plugins, Gemini settings, and MCP servers -- only to lose it all when you switch machines? nix-ai captures your entire AI setup as code using Nix. One command rebuilds everything, identically, every time.

• Nix (Determinate Nix recommended)
• home-manager
• Compatible platform: aarch64-darwin or x86_64-linux

Add to your Nix flake:

{
  inputs.nix-ai = {
    url = "github:JacobPEvans/nix-ai";
    inputs.nixpkgs.follows = "nixpkgs";
    inputs.home-manager.follows = "home-manager";
  };
}

Then in your home-manager config:

sharedModules = [ nix-ai.homeManagerModules.default ];

That's it. Every AI tool, every plugin, every permission rule — managed by Nix.

nix-ai exports home-manager modules that merge into your existing configuration:

The module injects its own dependencies via _module.args. Your consuming flake only needs two lines:

inputs.nixpkgs.follows = "nixpkgs";
inputs.home-manager.follows = "home-manager";

No AI-specific inputs to wire up. No extra configuration. It just works.

Key enable toggles exposed by the default module:

For the full option set, see modules/claude/options.nix.

Run quality checks locally:

nix flake check

This runs formatting (nixfmt), static analysis (statix), dead code detection (deadnix), shell script linting (shellcheck), and full module evaluation (module-eval) to verify the home-manager module instantiates correctly with real inputs.

Fix formatting automatically:

nix fmt

modules/
├── claude/          # Claude Code module — see [modules/claude/README.md](modules/claude/README.md)
├── maestro/         # Maestro agent orchestration
├── mcp/             # 15+ MCP server definitions
├── common/          # Shared permission engine
├── gh-extensions/   # GitHub CLI extensions (gh-aw)
├── permissions/     # Per-tool permission rules
├── mlx/             # MLX inference server (vllm-mlx)
├── ai-tools.nix     # AI development tool packages
├── gemini.nix       # Gemini CLI configuration
├── copilot.nix      # GitHub Copilot configuration
└── codex.nix        # OpenAI Codex configuration
lib/                  # Key lib files (not full listing)
├── claude-settings.nix    # Pure settings generator
└── claude-registry.nix    # Marketplace format functions

This repo is one of three that work together:

MIT