Skip to main content
← back to extensions

@keeb/tailscale

v2026.04.22.3

Install Tailscale on remote VMs over SSH and sync tailnet machine inventory from tailscale status JSON into per-machine resources.

Repository

https://github.com/keeb/swamp-tailscale

Platforms

linux-x86_64linux-aarch64darwin-x86_64darwin-aarch64

Labels

tailscalenetworkingvpnsecurity

Quality score

How well-documented and verifiable this extension is.

100%

Grade A

  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Has description1/1earned
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned

Install

$ swamp extension pull @keeb/tailscale

Security Notice

This extension includes AI agent skills that can modify AI assistant behavior. Review the skill files before installing.

@keeb/tailscale/nodev2026.02.11.1tailscale_node.ts

Global Arguments

ArgumentTypeDescription
sshHoststringSSH hostname/IP of the target VM (set via CEL from testVm)
sshUserstringSSH user (default 'root')
installInstall Tailscale on an Alpine VM, start the daemon, and authenticate
ArgumentTypeDescription
authKeystringTailscale auth key for non-interactive login

Resources

result(infinite)— Tailscale install result
@keeb/tailscale/netv2026.02.14.2tailscale_net.ts
syncParse tailscale status JSON and write a named resource per machine
ArgumentTypeDescription
statusJsonstringRaw JSON output from tailscale status --json

Resources

machine(infinite)— Tailnet machine

@keeb/setup-tailscale9e09f483-fac8-478f-a03e-1bf70d14a7a9

Install Tailscale and authenticate on a running VM by name

setupAuth, lookup VM via fleet, install Tailscale
1.authkeebDev02.auth— Authenticate with Proxmox via keebDev02
2.lookupfleet.lookup— Look up VM to get IP
3.install-tailscaletailscaleNode.install— Install Tailscale and authenticate

tailscale1 file