teamtype-share(1)

💅 teamtype-share — from the General Commands Manual bestie collection

okay so real talk, welcome to teamtype-share(1) — this is the page for sharing a directory with a new peer, and honestly? it's giving "let's collaborate, but make it ✨secure✨". I gotchu, let's go 🫶

---

🌸 NAME 🌸

teamtype-share — Share a directory with a new peer 💖

---

✨ SYNOPSIS ✨

teamtype share [--init] [--no-join-code] [--show-secret-address]
[--directory] [--sync-vcs] [--magic-wormhole-relay] [--iroh-relay]
[--iroh-dns-domain] [--iroh-pkarr-relay] [--username]
[-t|--temporary-directory] [-h|--help] [-V|--version]

---

🦋 DESCRIPTION 🦋

Share a directory with a new peer. that's the whole vibe, short and iconic, no notes 💅

---

🎀 OPTIONS 🎀

• --init — Re-initialize the history of the shared directory. bestie, you will loose previous history. like, it's gone-gone 😭 so know what you're doing before you type it.
• --no-join-code — Do not generate a join code. this is the one for when you wanna prevent unintended sharing, or simply when you want to keep Magic Wormhole out of the loop entirely. lowkey the "leave me alone" flag fr fr 🙈
• --show-secret-address — Print the secret address. useful for sharing with multiple people — like, you only gotta pull it up once and then share it around 👑 iykyk.
• --directory <DIRECTORY> — The shared directory. defaults to the current directory, so if you're already standing in the right spot, you can just vibe and not type anything 🫶
• --sync-vcs — EXPERIMENTAL: also synchronize 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. it's giving group-project-in-one-repo energy 🔥 but remember the EXPERIMENTAL part, periodt.
• --magic-wormhole-relay <MAGIC_WORMHOLE_RELAY> — Use an alternative Magic Wormhole mailbox server relay url. your relay, your rules 💅
• --iroh-relay <IROH_RELAY> — Use an alternative Iroh relay url. same energy, different relay 🦋
• --iroh-dns-domain <IROH_DNS_DOMAIN> — Use an alternative Iroh DNS origin domain. swap in the domain you actually want ✨
• --iroh-pkarr-relay <IROH_PKARR_RELAY> — Use an alternative Iroh Pkarr relay server. yep, that too 🧚
• --username <USERNAME> — The name that others see next to your cursor. defaults to your Git username. main character label energy, honestly 👑
• -t, --temporary-directory — Create a new temporary directory and use it as the shared directory. the temporary directory is removed on exit. it gets 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/. built-in cleanup? we love a self-sufficient queen 🍓
• -h, --help — Print help. when you're lost, this is the map 🗺️
• -V, --version — Print version. for the curious girlies ⭐

---

🌈 VERSION 🌈

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

---

and that's the whole page, bestie — no cap, every flag accounted for 💜 now go share that directory, slay, and remember: --init will loose your history and I cannot fix that for you 😭

🎀 sign-off time: this was teamtype-share(1) — share 0.9.3 (009c1931a 2026-10-28), published in the General Commands Manual, dated 2026-10-28. mwah, see you in the group chat 💖✨