Nix Agent Init

Genererar AGENT_MAP.md/CLAUDE.md/.mcp.json för ett NixOS- eller Home Manager-repo, faktabaserat via nix-agent MCP-servern.

av JEFF7712 · JEFF7712/nix-agent

Fungerar med konfiguration ★ 8.8/10

Nix Agent Init — Genererar AGENT_MAP.md/CLAUDE.md/.mcp.json för ett NixOS- eller Home Manager-repo, faktabaserat via nix-agent MCP-servern.

Vad den gör

Onboardar ett NixOS/Home Manager flake config-repo för kodningsagenter: kör `nix-agent inspect-flake` för att få ett faktabundel, skriver sedan en AGENT_MAP.md routing-tabell, en en-skärms CLAUDE.md/AGENTS.md brief, och en .mcp.json som kopplar nix-agent och mcp-nixos — varje rad spårad till ett observerat faktum, med ett markörbaserat kontrakt så att omkörningar aldrig skriver över handskriven innehåll. Triggar när användaren vill ha ett Nix-repo gjort agent-redo och värden redan exponerar nix-agent MCP-servern.

Testrapport

Fristående SKILL.md med ett ovanligt disciplinerat no-invention, markör-begränsat omkörningskontrakt, men det är hårt beroende av en separat nix-agent CLI+MCP-server (ett följeslagarprojekt som kräver Nix självt, inte på npm/brew) som inte finns i en normal miljö; att simulera faktabundlet för hand producerade fortfarande grundade, faktabaserade AGENT_MAP.md/CLAUDE.md/.mcp.json som var klart bättre än ett generiskt onboarding-dokument utan färdighet.

Testad: 2026-07-16 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/JEFF7712/nix-agent
cd nix-agent
mkdir -p ~/.claude/skills
cp -r skills/nix-agent-init ~/.claude/skills/nix-agent-init

Kommandon och exempelprompter

  • /nix-agent-initGenererar AGENT_MAP.md/CLAUDE.md/.mcp.json för ett NixOS- eller Home Manager-repo, faktabaserat via nix-agent MCP-servern.

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

  • Make this NixOS flake repo ready for coding agents with a map file
  • Generate an AGENT_MAP and CLAUDE.md for my Home Manager config repo
  • Wire up MCP servers so agents can safely inspect my Nix flake config