Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
alsk1992 avatar

Tailscale

  • 12 installs
  • 610 repo stars
  • Updated June 26, 2026
  • alsk1992/cloddsbot

tailscale is a skill that shares local services over a Tailscale tailnet with Serve and exposes them publicly with Funnel.

About

This skill wraps Tailscale to share local services over a private tailnet using Serve and to expose ports publicly using Funnel. It also reports network status, lists and pings peers, and transfers files between machines. A developer uses it to reach a locally running bot or dev server remotely, or to make a webhook endpoint publicly accessible.

  • Shares local services over a Tailscale tailnet with Serve (private)
  • Exposes local ports to the public internet with Funnel
  • Peer status, ping, and file transfer over the tailnet

Tailscale by the numbers

  • 12 all-time installs (skills.sh)
  • Ranked #836 of 1,039 Cloud & Infrastructure skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
At a glance

tailscale capabilities & compatibility

Requires a Tailscale account and optional TAILSCALE_AUTHKEY; Tailscale has a free tier.

Capabilities
port sharing · public tunnel · peer networking · file transfer
Use cases
devops
Runs
Runs locally
Pricing
Bring your own API key
From the docs

What tailscale says it does

Share local services via Tailscale Serve (private) and Funnel (public internet access).
SKILL.md
Add authentication** — Funnel bypasses Tailscale auth
SKILL.md
npx skills add https://github.com/alsk1992/cloddsbot --skill tailscale

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs12
repo stars610
Last updatedJune 26, 2026
Repositoryalsk1992/cloddsbot

What it does

Share a local service privately over a tailnet or publicly via Tailscale Funnel.

Who is it for?

Reaching a locally running bot or dev server remotely, or exposing a webhook endpoint.

Skip if: Managing cloud provider infrastructure or container orchestration.

When should I use this skill?

You need to share a local port privately over a tailnet or publicly to the internet.

What you get

The service is reachable over the tailnet (Serve) or the public internet (Funnel).

  • Private tailnet URL (Serve)
  • Public internet URL (Funnel)

By the numbers

  • Serve vs Funnel comparison across 4 attributes
  • 3 use-case examples

Files

SKILL.mdMarkdownGitHub ↗

Tailscale - Complete API Reference

Share local services via Tailscale Serve (private) and Funnel (public internet access).

---

Chat Commands

Share Local Services (Private)

/tailscale serve 3000                       Share port on tailnet
/tailscale serve 3000 --path /api           Share at specific path
/tailscale serve stop 3000                  Stop sharing port
/tailscale serve status                     View active shares

Public Access (Funnel)

/tailscale funnel 3000                      Expose to internet
/tailscale funnel 3000 --https              Force HTTPS
/tailscale funnel stop 3000                 Stop public access
/tailscale funnel status                    View funnels

Network Status

/tailscale status                           Network status
/tailscale ip                               Show Tailscale IP
/tailscale peers                            List connected peers
/tailscale ping <peer>                      Ping a peer

File Transfer

/tailscale send <file> <peer>               Send file to peer
/tailscale receive                          Receive incoming files

---

TypeScript API Reference

Create Tailscale Client

import { createTailscaleClient } from 'clodds/tailscale';

const tailscale = createTailscaleClient({
  // Auth (optional if already logged in)
  authKey: process.env.TAILSCALE_AUTHKEY,

  // Socket path
  socketPath: '/var/run/tailscale/tailscaled.sock',
});

Serve (Private Sharing)

// Share local port on tailnet
await tailscale.serve({
  port: 3000,
  protocol: 'https',  // 'http' | 'https'
});

console.log(`Shared at: https://${tailscale.hostname}:3000`);

// Share at specific path
await tailscale.serve({
  port: 8080,
  path: '/api',
  protocol: 'https',
});

// Share with custom hostname
await tailscale.serve({
  port: 3000,
  hostname: 'clodds',  // clodds.tailnet-name.ts.net
});

// Stop sharing
await tailscale.serveStop(3000);

// Get serve status
const serves = await tailscale.serveStatus();
for (const serve of serves) {
  console.log(`Port ${serve.port} → ${serve.url}`);
}

Funnel (Public Internet)

// Expose to public internet
await tailscale.funnel({
  port: 3000,
  protocol: 'https',
});

console.log(`Public URL: https://${tailscale.hostname}.ts.net`);

// With custom domain (if configured)
await tailscale.funnel({
  port: 3000,
  hostname: 'api.example.com',
});

// Stop funnel
await tailscale.funnelStop(3000);

// Get funnel status
const funnels = await tailscale.funnelStatus();
for (const funnel of funnels) {
  console.log(`Port ${funnel.port} → ${funnel.publicUrl}`);
}

Network Status

// Get status
const status = await tailscale.status();

console.log(`Hostname: ${status.hostname}`);
console.log(`IP: ${status.ip}`);
console.log(`Tailnet: ${status.tailnet}`);
console.log(`Online: ${status.online}`);

// List peers
const peers = await tailscale.peers();
for (const peer of peers) {
  console.log(`${peer.hostname} (${peer.ip})`);
  console.log(`  OS: ${peer.os}`);
  console.log(`  Online: ${peer.online}`);
  console.log(`  Last seen: ${peer.lastSeen}`);
}

// Ping peer
const ping = await tailscale.ping('other-machine');
console.log(`Latency: ${ping.latencyMs}ms`);

File Transfer

// Send file to peer
await tailscale.sendFile({
  file: '/path/to/file.zip',
  peer: 'other-machine',
});

// Receive files (returns when file received)
const received = await tailscale.receiveFile({
  savePath: '/downloads',
  timeout: 60000,
});

console.log(`Received: ${received.filename}`);
console.log(`From: ${received.sender}`);
console.log(`Size: ${received.size} bytes`);

Get Tailscale IP

const ip = await tailscale.getIP();
console.log(`Tailscale IP: ${ip}`);  // 100.x.x.x

---

Serve vs Funnel

FeatureServeFunnel
AccessTailnet onlyPublic internet
AuthTailscale identityNone (public)
URLmachine.tailnet.ts.netmachine.ts.net
Use caseInternal toolsPublic APIs

---

URL Formats

TypeFormat
Servehttps://machine.tailnet-name.ts.net:port
Funnelhttps://machine.ts.net
Custom domainhttps://your-domain.com

---

Use Cases

Share Dev Server

// Share local dev server with team
await tailscale.serve({ port: 3000 });
// Team can access at https://your-machine.tailnet.ts.net:3000

Expose Webhook Endpoint

// Make webhook publicly accessible
await tailscale.funnel({ port: 3000, path: '/webhooks' });
// External services can POST to https://your-machine.ts.net/webhooks

Share Bot with Phone

// Access bot from phone while away from desk
await tailscale.serve({ port: 18789 });
// Open https://your-machine.tailnet.ts.net:18789/webchat on phone

---

Requirements

  • Tailscale installed and running
  • Logged into a Tailnet
  • For Funnel: Funnel enabled in Tailscale admin

---

Best Practices

1. Use Serve for internal — Keep private services private 2. Use Funnel sparingly — Only for truly public endpoints 3. Add authentication — Funnel bypasses Tailscale auth 4. Monitor access — Check who's connecting 5. Stop when done — Don't leave services exposed

Related skills

FAQ

What is the difference between Serve and Funnel?

Serve shares a port on the tailnet only (Tailscale identity auth); Funnel exposes it to the public internet with no auth.

What is required to use Funnel?

Tailscale installed and running, logged into a tailnet, and Funnel enabled in the Tailscale admin.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.