> ## Documentation Index
> Fetch the complete documentation index at: https://docs.augustin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Management

How AI agents manage homelab services, and what's not yet automatable.

## Approach

Each service directory has an `AGENTS.md` describing its management interface. Agents discover ports, URLs, and env var names at runtime from compose files and `.env` files — nothing is hardcoded.

Preference order:

1. CLI via `docker exec` or host-installed tools
2. REST API via `curl`
3. Config file edits + container restart

## Host Dev Environment

Node.js is managed via [fnm](https://github.com/Schniz/fnm) (installed to `~/.local/bin`), keeping the OS clean. Node versions and global packages live in `~/.local/share/fnm/`.

Globally installed tools:

* `wrangler` — Cloudflare CLI (Workers, DNS, tunnels, etc.)

## Gaps

Services that can't be fully managed by an agent today:

| Service           | Issue                                | Workaround                              |
| ----------------- | ------------------------------------ | --------------------------------------- |
| Miniflux          | No API key configured                | Generate one in UI: Settings → API Keys |
| Yamtrack          | Session-cookie auth only, no API key | None — UI only                          |
| Chaptarr          | No API or CLI                        | UI only                                 |
| Draw (Excalidraw) | No API or CLI                        | UI only, data in filesystem             |