dryvist/nix-ai

Your AI coding toolkit, declared once. Reproduced everywhere
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.
---
What it manages
| Tool | What you get |
| ---- | ------------ |
| **Claude Code** | Plugin ecosystem, hooks, agents, commands, rules |
| **Gemini / Antigravity** | CLI + IDE settings, custom commands, permission rules |
| **GitHub Copilot** | Configuration, permissions |
| **OpenAI Codex** | Settings, rules, approval policy |
| **Qwen Code & Cecli** | Settings for the Alibaba and Aider-fork CLIs |
| **MCP Servers** | One catalog (GitHub, Terraform, Context7, filesystem, memory, …) fanned out to every agent |
| **AI Dev Tools** | cclint, rulesync, and more |
| **MLX** *(macOS)* | Local Apple Silicon inference via mlx_lm.server behind llama-swap, with launchd integration |
Claude Code, Codex and Antigravity CLI are always configured. The other agent CLIs
(Copilot, OpenCode, Qwen Code, Cecli, claude-zai, claude-flow) are
installed only when programs.ai.untrustedClis.enable = true. oh-my-openagent (the
OpenCode plugin entry and the omo-senpi wrapper) is off by default and needs
programs.ai.ohMyOpenagent.disabled = false; omo-senpi also needs the untrusted gate.
Prerequisites
- Nix with flakes (Determinate Nix recommended)
- home-manager
- A supported platform: aarch64-darwin or x86_64-linux
Installation
Add the input to your flake:
Then add the module to your home-manager config:
That's it. The module evaluates with **zero extra configuration** — every AI tool,
plugin, and permission rule comes preconfigured. (Local MLX inference stays idle
until you point it at a model; see Usage.)
How it works
nix-ai exports home-manager modules
that merge into your existing configuration:
| Export | What it includes |
| ------ | --------------- |
| homeManagerModules.default | The full AI stack — every tool below |
| homeManagerModules.claude | Just Claude Code |
| homeManagerModules.codex | Just OpenAI Codex |
| homeManagerModules.mcp | Just the MCP server catalog |
| homeManagerModules.maestro | Just Maestro orchestration |
| *(also: agent-skills, antigravity-cli, antigravity-ide, cecli, qwen-code)* | One module per tool |
| lib.ci.claudeSettingsJson | Pure settings JSON for CI validation (no derivations) |
| lib.aiStackModels | Role-name → model-ID registry, for foreign (non-module) consumers |
Self-contained design
The module injects its own dependencies via _module.args. Your consuming flake
only needs two follows lines:
No AI-specific inputs to wire up, no extra configuration. It just works.
Usage
Everything is enabled with sensible defaults. Common toggles on the default module:
| Option | Type | Default | Description |
| ------ | ---- | ------- | ----------- |