A local MCP server that gives AI agents composable NixOS / Home Manager operations: build, diff, switch, and generations for the operational core, plus eval, locate, and check for config introspection.
It pairs with mcp-nixos. nix-agent
operates on your actual configuration, mcp-nixos handles package and option
discovery. Optional local usage logging (NIX_AGENT_USAGE_LOG=1) records
per-call byte accounting; run nix-agent usage to summarize.
The documented default is high trust: unprompted switch / generations
and passwordless sudo narrowed to this machine's flake. Lower trust (host
prompts, a sudo password) is an opt-down.
Experimental and a work in progress. Feedback and contributions welcome.
Install
Paste this to a coding agent (Codex, Claude Code, opencode, ...) and it does the install:
Read https://raw.githubusercontent.com/JEFF7712/nix-agent/main/docs/agent-install.md and follow every step to install nix-agent on this NixOS system, install the companion skills, and register nix-agent in my MCP settings for this machine.
Or do it by hand, see docs/usage.md.
Docs
- docs/usage.md: install, MCP host config, tool surface, workflow, design notes
- docs/agent-install.md: high-trust install guide for agents
- docs/privileged-automation.md: default non-interactive dry-activate, switch, and rollback (opt-down for a sudo password)
- skills/nix-agent/SKILL.md: companion workflow skill
- skills/nix-agent-init/SKILL.md: repo onboarding skill
The nix-agent logo adapts the Nix snowflake from NixOS/nixos-artwork, licensed CC-BY 4.0.