t1k:netbird-share
| Field | Value |
|---|---|
| Module | t1k-base |
| Version | 5.15.36 |
| Effort | low |
| Tools | — |
Keywords: artifact, artifact link, chia sẻ page, download link, gallery, gửi file qua netbird, html report, link tải, netbird share, open artifact, open on phone, preview page, publish page, share apk, share build, share over vpn, share page, theone.netbird, view artifact, view report, xem artifact, xem page, xem trên điện thoại
How to invoke
Section titled “How to invoke”/t1k:netbird-share--page <html|dir> [--slug S] | <file>... | --list | --rm <slug> | --statusNetBird Share — your own artifact gallery for studio peers
Section titled “NetBird Share — your own artifact gallery for studio peers”Every user hosts their own pages on their own machine. Any device connected to TheOne VPN (NetBird, see t1k-vpn) opens:
| What | Link |
|---|---|
| Your gallery (all your pages + files, newest first, filter box) | http://<peer>.theone.netbird:8800/ |
| One page | http://<peer>.theone.netbird:8800/<page>/ |
| One file | http://<peer>.theone.netbird:8800/files/<name> |
<peer> is this machine’s NetBird name (netbird status --json → fqdn). NetBird DNS resolves it on every peer: no DNS records, no tokens, no admin step. The gallery header shows the owner (git config user.name, or NB_SHARE_OWNER).
NetBird only. Do not route this through Tailscale (studio legacy) or the studio domain.
Use this instead of a claude.ai artifact
Section titled “Use this instead of a claude.ai artifact”When the user wants to see something Claude produced (an artifact, an HTML page or report, a chart page, a build to download), publish it here and hand over the verified link. Do not create a claude.ai artifact unless the user names claude.ai or Artifact. Write the page to a file in the session scratchpad, publish it with a stable --slug named after the task, and republish to the same slug to update it in place. One page per topic, not one per message.
How to use
Section titled “How to use”The script installs/updates the systemd user service on demand, copies the content in, fetches it back over the NetBird name and checks HTTP 200 plus the exact byte count before printing a link. Only hand out links it printed as verified.
S=~/.claude/skills/t1k-netbird-share/scripts/share.shbash $S --page report.html --slug perf-ab # publish one page (stable slug = stable link)bash $S --page ./site-dir # dir with index.html + assetsbash $S build.apk notes.zip # download filesbash $S --list # every entry with its linkbash $S --rm perf-ab | bash $S --rm files/build.apkbash $S --status # service, link, linger- Slug defaults to the slugified
<title>. Republishing a slug replaces it in place (same link), so give pages you update a fixed--slug.filesis reserved. - Content is copied: re-run after rebuilding. Pages must be self-contained or ship their assets in the page dir.
How it works
Section titled “How it works”netbird-share.service(systemd user unit) runsscripts/server.py, bound to this peer’s NetBird IPv4 only (resolved at start; it retries every 10 s until NetBird is up). The index is rendered on every request, so it is never stale.- Content lives in
~/netbird-share/<slug>/(+meta.json) and~/netbird-share/files/. - Plain HTTP on purpose:
.netbirdnames cannot get a public certificate, and NetBird traffic is already WireGuard-encrypted end to end. Pages that need a secure context (clipboard API, service workers) will not get one. - Env overrides:
NB_SHARE_PORT(default 8800),NB_SHARE_DIR,NB_SHARE_OWNER.
- Everyone on the studio NetBird can open every entry, and studio access policies decide which peers reach you. Never publish secrets, credentials,
.envfiles or client-confidential material. - Never bind
0.0.0.0or port-forward. The NetBird-IP bind is the access control. - Linger off means the share stops at logout and does not start at boot. Enabling it (
loginctl enable-linger $USER) is the user’s call, so ask first. - Linux with systemd only for now. On macOS or Windows, say so instead of improvising.
Troubleshoot
Section titled “Troubleshoot”| Symptom | Check |
|---|---|
NetBird is not connected | netbird status. Reconnect with the t1k-vpn skill. |
| verify failed / not answering | systemctl --user status netbird-share, journalctl --user -u netbird-share |
| Teammate cannot open the link | They must be Connected (greeting.the1studio.org must greet), and a studio access policy must allow their group to reach your peer on 8800. |
| Port taken | Set NB_SHARE_PORT, then share.sh --install. |
Executed by
Section titled “Executed by”Runs inline or in t1k-git-manager. Every step is a scripts/share.sh subcommand (install, publish, list, rm, status).
| Step | Agent |
|---|---|
Run scripts/share.sh publish / list / rm / status | t1k-git-manager |