tailnet-preview: my coding agent sends me a link
An agent skill that publishes previews on my tailnet, checks their HTTPS links and removes only what it published when I'm done. The previews also show up in tailhome.
I do most of my side-project coding on a small remote server, with agents I start from my phone through Herdr. In my last post, I wrote about tailhome, the start page I built to find the apps running on my tailnet.
Testing what the agent built was still a hassle, especially on my phone or another machine. And once I had a link, I had to dig it up again the next time. So I wrote a skill for it.
tailnet-preview is an agent skill: instructions and a small Python script that Claude Code, Codex, Gemini CLI and other agents can load. When I ask “can I see this on my phone?”, the agent publishes the app with Tailscale Serve, checks that the HTTPS link shows the app, and gives me the link. When I say I’m done, it removes only what it published.

It can also publish several versions side by side. If I ask for three versions of a hero section, it gives me three links, grouped as one set. If you run tailhome, the set appears at the top of home/ with the title and description the agent wrote. On my phone, I can switch between versions without copying URLs around.
Only devices allowed by your Tailscale access rules can open the links. The skill never uses Funnel, which would put them on the public internet.
It runs on Linux or macOS and needs Python 3.9 or later and the Tailscale CLI. It also works without tailhome. To install it:
npx skills add mickey/tailhome --skill tailnet-preview -g
In Claude Code, you can also add it as a plugin:
/plugin marketplace add mickey/tailhome
/plugin install tailnet-preview@tailhome
An AI wrote most of the skill, including the instructions for the agent. I tested it on my tailnet from my phone and my Mac, and reviewed the diffs.
The skill, its privacy notes and the other install options are on GitHub.