# 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:

```text
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

```bash
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.

```bash
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`.