tunnel-manager-host-inventory

Tunnel Manager — Host Inventory

Domain-typed access to the shared SSH inventory ($XDG_CONFIG_HOME/agent-utilities/inventory.yml) via the tunnel-manager MCP server. One inventory, shared with the HostManager library, container-manager, and the ssh-bootstrap skill.

When to use

• Register a new SSH target (alias → hostname / user / port / identity_file).
• List existing aliases or read how a host is reached.
• Remove a stale alias.
• Push the current inventory into the knowledge graph (:Host nodes).

When NOT to use

• Running a command / copying a file on a host → tunnel-manager-remote-execution.
• Passwordless key setup, key rotation, mesh, or security audit → tunnel-manager-ssh-hardening.
• Editing container/service definitions → container-manager skills.

Prerequisites & environment

Connect via the mcp-client skill against the tunnel-manager MCP server.

Variable	Required	Notes
TUNNEL_INVENTORY	optional	Inventory YAML path (defaults to the shared XDG file)
TUNNEL_INVENTORY_GROUP	optional	Default target group (all)
TUNNEL_KG_INGEST	optional	Set false to disable the default-on KG ingest on list

The inventory is an Ansible-style YAML (all → children → groups → hosts); the server flattens it to aliases automatically.

Tools & actions

Condensed tool	Actions
tm_hosts	list, add, remove
tunnel_ingest_hosts	(no action — lists + pushes to KG)

Key parameters

• alias — the inventory key; required for add / remove.
• hostname, user — required for add; port (default 22), identity_file, password, proxy_command optional.
• group (on tunnel_ingest_hosts) — the :HostGroup to attach hosts to.

Recipes

List every managed host (also default-on ingests them to the KG):

{"action": "list"}

Add a key-authenticated host:

{"action": "add", "alias": "rw710", "hostname": "10.0.0.14", "user": "genius", "port": 22, "identity_file": "~/.ssh/id_shared"}

Remove a stale alias (destructive — the server confirms):

{"action": "remove", "alias": "old-box"}

Sync the inventory into the knowledge graph:

{"group": "homelab"}