Nix Agent Init

Genera AGENT_MAP.md/CLAUDE.md/.mcp.json per un repo NixOS o Home Manager, tracciato tramite il server MCP nix-agent.

di JEFF7712 · JEFF7712/nix-agent

Richiede configurazione ★ 8.8/10

Nix Agent Init — Genera AGENT_MAP.md/CLAUDE.md/.mcp.json per un repo NixOS o Home Manager, tracciato tramite il server MCP nix-agent.

Cosa fa

Onboarding di un repo di configurazione flake NixOS/Home Manager per agenti di codifica: esegue `nix-agent inspect-flake` per ottenere un bundle di fatti, quindi scrive una tabella di routing AGENT_MAP.md, un breve CLAUDE.md/AGENTS.md di una schermata, e un .mcp.json che collega nix-agent e mcp-nixos — ogni riga tracciata a un fatto osservato, con un contratto basato su marcatori in modo che le riesecuzioni non sovrascrivano mai contenuti scritti a mano. Si attiva quando l'utente vuole che un repo Nix sia pronto per gli agenti e l'host espone già il server MCP nix-agent.

Rapporto di test

SKILL.md autonomo con un contratto di riesecuzione insolitamente disciplinato senza invenzioni e basato su marcatori, ma dipende rigidamente da una CLI/server MCP nix-agent separato (un progetto companion che richiede Nix stesso, non su npm/brew) che non è presente in un ambiente normale; simulare il bundle di fatti a mano ha comunque prodotto AGENT_MAP.md/CLAUDE.md/.mcp.json radicati e citati da fatti, chiaramente migliori di un documento di onboarding generico senza skill.

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

Installazione

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

Comandi e prompt di esempio

  • /nix-agent-initGenera AGENT_MAP.md/CLAUDE.md/.mcp.json per un repo NixOS o Home Manager, tracciato tramite il server MCP nix-agent.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • 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