https://github.com/JEFF7712/nix-agent
Agent MCP server + skill for managing your NixOS system
https://github.com/JEFF7712/nix-agent
claude-code claude-skills mcp mcp-server
Last synced: 4 days ago
JSON representation
Agent MCP server + skill for managing your NixOS system
- Host: GitHub
- URL: https://github.com/JEFF7712/nix-agent
- Owner: JEFF7712
- License: mit
- Created: 2026-03-19T03:57:49.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-07-13T21:30:41.000Z (7 days ago)
- Last Synced: 2026-07-13T23:15:06.241Z (7 days ago)
- Topics: claude-code, claude-skills, mcp, mcp-server
- Language: Python
- Homepage: https://nix-agent.rupan.dev/
- Size: 1.03 MB
- Stars: 14
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-claude-skills - JEFF7712/nix-agent
README
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`](https://github.com/utensils/mcp-nixos). nix-agent
operates on your actual configuration, `mcp-nixos` handles package and option
discovery. Responses report raw vs returned bytes so token savings are
visible per call, not just claimed.
> **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/usage.md#install).
## Docs
- [docs/usage.md](docs/usage.md): install, MCP host config, tool surface, workflow, design notes
- [docs/agent-install.md](docs/agent-install.md): install guide for agents
- [docs/privileged-automation.md](docs/privileged-automation.md): non-interactive dry-activate, switch, and rollback
- [skills/nix-agent/SKILL.md](skills/nix-agent/SKILL.md): companion workflow skill
- [skills/nix-agent-init/SKILL.md](skills/nix-agent-init/SKILL.md): repo onboarding skill
---
The nix-agent logo adapts the Nix snowflake from [NixOS/nixos-artwork](https://github.com/NixOS/nixos-artwork), licensed [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/).