Agent Hub¶

Agent Hub is a personal AI agent hub — the canonical source for my agent configuration, MCP tool connections, and runtime wiring across VS Code GitHub Copilot, OpenCode, and OpenWebUI.

Everything in this repository has one job: make my agents work consistently across all AI clients without manual re-configuration per tool.

What this repo manages¶

Agent configuration — Prompt files and instruction overlays under .github/prompts/ and .github/instructions/. One source of truth, synced automatically to VS Code GitHub Copilot, OpenCode, and OpenWebUI.

MCP tools — A local Docker gateway connecting AI agents to external services: Home Assistant, Bitwarden, GitHub, MQTT brokers, SSH hosts, and more. Managed via Arion and Nix, fronted by Traefik.

AI client wiring — .mcp.json as the single MCP config source, symlinked to VS Code and projected to OpenCode. just sync-ai regenerates all derived configs from canonical sources.

Secrets — Bitwarden vault as source of truth. .env as the local working copy. just bw-env-hydrate pulls all runtime secrets in one command.

Start here¶

• Quickstart — first-time environment setup
• How It Works — how all the pieces connect
• Agent System — agent roster and per-client delivery
• Secrets and Bitwarden — credential management workflow

MCP guides¶

Each guide covers enabling one integration: credentials, health check, and example prompts.

• MCP Overview — namespaces, profiles, and config model
• MCP Gateway Stack — runtime stack and commands
• Home Assistant
• MQTT
• ZigBee2MQTT
• Paperless-NGX
• SSH Gateway
• Vault
• YouTube
• Browser Automation
• Bitwarden Hello World