The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
plugin-catalog: repin netplane 0.3.0 with approved Headscale setup
Jeffrey Watts230a40ea6f75
diff --git a/plugin-catalog/netplane.yaml b/plugin-catalog/netplane.yamlindex 0e7848a861d..6b6aba60558 100644--- a/plugin-catalog/netplane.yaml+++ b/plugin-catalog/netplane.yaml@@ -1,32 +1,37 @@name: netplanerepo: https://github.com/lEWFkRAD/netplane-sha: cdda4d5e6d7484a79364af9e1a233b1333d26700+sha: 10b6bff5cf5bb521d39e4443d9d33ee6768fbb23description: >-- Run and operate your own self-hosted Tailscale network (a Headscale control plane) from- inside Hermes: netplane_status checks local service/serve wiring and gRPC node health,- netplane_nodes lists tailnet devices with addresses, last-seen and online state, and- netplane_preauth lists preauth-key metadata without stored join secrets or, after explicit- approval, mints and returns a new single-use-by-default join secret with a 1–168 hour- lifetime. Ships a Desktop pane with health status, node rows, preauth-key rows and a New- join key action, plus a FastAPI backend under /api/plugins/netplane. Headscale v0.29.6- protobuf stubs are bundled; scripts/gen_proto.sh pins its upstream sources and toolchain.- Requires a reachable Headscale control plane with gRPC enabled and NETPLANE_APIKEY in the- active Hermes profile's secret scope; the plugin installs no server and never reads- credentials from process environment or disk. Disclosure — read-only against the control- plane except explicit preauth-key creation and user-confirmed node expiration in Desktop;- loopback gRPC may use plaintext while non-loopback targets use TLS with system trust.- Status runs systemctl is-active headscale and tailscale serve status best-effort. Node- names, hostnames and IPs stay between Hermes and the configured control plane; there is no- telemetry or third-party service.+ Install, configure and operate a self-hosted Headscale control plane from Hermes.+ netplane_setup previews a configuration and, after approval, installs the pinned official+ Headscale v0.29.6 DEB on a fresh Debian 12+ or Ubuntu 22.04+ systemd host (amd64/arm64).+ Installation runs on the Hermes host, requires root or noninteractive sudo, refuses+ existing deployments, and verifies the package SHA-256. It configures SQLite, MagicDNS,+ embedded DERP/STUN, local admin gRPC, and either Let's Encrypt HTTPS or a loopback backend+ for an existing reverse proxy. It starts the system service, creates the first user, and+ saves a 90-day API key and connection settings through Hermes's active-profile APIs.+ netplane_status reports health, netplane_nodes lists devices, and netplane_preauth lists+ metadata without stored join secrets or creates an approval-gated, single-use-by-default+ join key with a 1–168 hour lifetime. Desktop includes setup preview/confirmation, health,+ nodes, join keys and confirmed node expiration, with a FastAPI backend. Management requires+ NETPLANE_APIKEY; setup works before a key exists. Bundled protobuf stubs use pinned sources+ and a compatible toolchain. Disclosure — explicit installation downloads from GitHub and+ may contact configured APT repositories; Let's Encrypt receives the chosen domain/email.+ Setup uses APT/dpkg, systemctl, runuser and Headscale commands, writes system configuration+ and data, and enables a persistent service with the listeners shown in its preview.+ Public DNS/firewall changes, proxy installation, upgrades and device migration are not+ performed. Partial installs are preserved for repair. Management reads credentials only+ from Hermes; off-host gRPC uses TLS with system trust. Status also runs systemctl is-active+ headscale and tailscale serve status. No telemetry or automatic software updates.maintainer: lEWFkRADtier: communitycategory: tools-requires_hermes: ">=0.19"+requires_hermes: ">=0.21.6"docs_url: https://github.com/lEWFkRAD/netplane#readme-version: "0.2.0"+version: "0.3.0"platforms: []capabilities:- provides_tools: [netplane_status, netplane_nodes, netplane_preauth]+ provides_tools: [netplane_setup, netplane_status, netplane_nodes, netplane_preauth]provides_hooks: [pre_tool_call]provides_middleware: []- requires_env: [NETPLANE_APIKEY]+ requires_env: []