teamtype-join(1)

📦
version 0.9.3 · 2 versions
, in arch rolling

💖 teamtype-join 💖

okay bestie so this is a page from the General Commands Manual — it's teamtype-join(1) and it's literally the cutest way to hop into a shared directory. buckle up 🎀

✨ NAME ✨

teamtype-join — join a shared directory via a join code, or connect to the most recent one 🫶

🌸 SYNOPSIS 🌸

teamtype join [--sync-vcs] [--magic-wormhole-relay] [--iroh-relay]
[--directory] [--iroh-dns-domain] [--iroh-pkarr-relay] [--username]
[-t|--temporary-directory] [-h|--help] [-V|--version] [JOIN_CODE]

🦋 DESCRIPTION 🦋

Join a shared directory via a join code, or connect to the most recent one. that's the whole vibe. main character energy, one command, boom you're in 💅

⭐ OPTIONS ⭐

  • --sync-vcs — EXPERIMENTAL bestie, listen 😭 this one also synchronizes version-control directories like .git/ or .jj/, which are normally ignored. For Git, this will synchronize all branches, commits, etc. as well as your .git/config. That means new commits will immediately appear at all peers, you can change branches together, etc. chaotic? yes. iconic? also yes 🔥
  • --magic-wormhole-relay <MAGIC_WORMHOLE_RELAY> — use an alternative Magic Wormhole mailbox server relay url 🧚
  • --iroh-relay <IROH_RELAY> — use an alternative Iroh relay url ⭐
  • --directory <DIRECTORY> — the shared directory. Defaults to current directory 🍓
  • --iroh-dns-domain <IROH_DNS_DOMAIN> — use an alternative Iroh DNS origin domain 🌈
  • --iroh-pkarr-relay <IROH_PKARR_RELAY> — use an alternative Iroh Pkarr relay server 💜
  • --username <USERNAME> — the name that others see next to your cursor. Defaults to your Git username 👑 (yes, your cursor is a whole personality)
  • -t, --temporary-directory — create a new temporary directory and use it as the shared directory. The temporary directory is removed on exit. The temporary directory is created in $XDG_CACHE_DIR/teamtype/, or if XDG_CACHE_DIR is not set in $HOME/.cache/teamtype/, or if HOME is not set in /home/$USER/.cache/teamtype/ 🎀
  • -h, --help — print help 🙈
  • -V, --version — print version ✨
  • [JOIN_CODE] — specify to connect to a new peer. Otherwise, try to connect to the most recent peer 💫
ngl the -t fallback chain is a whole little ladder — $XDG_CACHE_DIR/teamtype/ → $HOME/.cache/teamtype/ → /home/$USER/.cache/teamtype/ — so keep that in mind, it's not just one path, it's giving "depends on your env" 😌

💀 VERSION 💀

v0.9.3 (009c1931a 2026-10-28)

okay that's the whole page, no cap 💖 stay slaying, and remember: every single flag above is real, so don't go inventing your own ✨

this has been join 0.9.3 (009c1931a 2026-10-28) — teamtype-join(1), general commands manual, dated 2026-10-28. mwah 🫶💅

📦 where this page comes from