Skip to content

t1k:netbird-share

FieldValue
Modulet1k-base
Version5.15.36
Effortlow
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

/t1k:netbird-share
--page <html|dir> [--slug S] | <file>... | --list | --rm <slug> | --status

NetBird 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:

WhatLink
Your gallery (all your pages + files, newest first, filter box)http://<peer>.theone.netbird:8800/
One pagehttp://<peer>.theone.netbird:8800/<page>/
One filehttp://<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.

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.

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.

Terminal window
S=~/.claude/skills/t1k-netbird-share/scripts/share.sh
bash $S --page report.html --slug perf-ab # publish one page (stable slug = stable link)
bash $S --page ./site-dir # dir with index.html + assets
bash $S build.apk notes.zip # download files
bash $S --list # every entry with its link
bash $S --rm perf-ab | bash $S --rm files/build.apk
bash $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. files is reserved.
  • Content is copied: re-run after rebuilding. Pages must be self-contained or ship their assets in the page dir.
  • netbird-share.service (systemd user unit) runs scripts/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: .netbird names 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, .env files or client-confidential material.
  • Never bind 0.0.0.0 or 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.
SymptomCheck
NetBird is not connectednetbird status. Reconnect with the t1k-vpn skill.
verify failed / not answeringsystemctl --user status netbird-share, journalctl --user -u netbird-share
Teammate cannot open the linkThey must be Connected (greeting.the1studio.org must greet), and a studio access policy must allow their group to reach your peer on 8800.
Port takenSet NB_SHARE_PORT, then share.sh --install.

Runs inline or in t1k-git-manager. Every step is a scripts/share.sh subcommand (install, publish, list, rm, status).

StepAgent
Run scripts/share.sh publish / list / rm / statust1k-git-manager