DmitryandClaude Opus 5
ef234b17f5
Knowing how to run something required reading ansible/README.md and remembering to source .env first. Provide `make help` instead, with targets grouped by purpose and pattern rules for the repetitive families: deploy-%, dry-%, update-% and play-%. .env is sourced automatically; targets that need Proxmox credentials fail with an actionable message when it is missing. Destructive targets -- mihomo-harden, which rotates live credentials, the frozen monitoring stack, and update-all -- require CONFIRM=1. The interpreter is resolved at runtime rather than hardcoded to .venv: the repository's venv is currently broken, so the Makefile falls back to whatever is on PATH, which is what the Nix devshell provides. gen-inventory-docs.py prints the host and group tables from ansible-inventory, so documentation can be regenerated instead of being maintained by hand and drifting. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GTocXkGUUazHdKKd3r9k71
HomeLab Infrastructure
Active HomeLab infrastructure is managed through Ansible.
Active Files
ansible/— current control plane.ansible/inventory/hosts.yml— inventory and host facts.ansible/playbooks/check.yml— safe connectivity/facts check.
Archive
Historical pre-Proxmox material is kept under:
archive/2026-07-proxmox-migration/
It contains old NixOS configs, Docker Compose service definitions, Gitea workflows, deploy scripts and old Ansible bootstrap playbooks.
Basic Check
cd ansible
ansible-playbook playbooks/check.yml
Grimmory MCP
tools/grimmory-mcp/ contains the read-only Grimmory API integration for
OpenCode and the explicitly invoked Obsidian synchronization tools.
npm install --prefix tools/grimmory-mcp
npm run configure --prefix tools/grimmory-mcp
npm test --prefix tools/grimmory-mcp
OpenCode registers the server globally. After restarting OpenCode, use
/grimmory-sync to update individual book notes under 90 Library/Books and
covers under 99 System/Export/Grimmory/Covers.