Reference

teamtype-share(1)

Share a directory with a new peer

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

OPTIONS

--init

Re-initialize the history of the shared directory. You will loose previous history

--no-join-code

Do not generate a join code. To prevent unintended sharing or simply if you want to keep Magic Wormhole out of the loop

--show-secret-address

Print the secret address. Useful for sharing with multiple people

--directory <DIRECTORY>

The shared directory. Defaults to current directory

--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. This means that new commits will immediately appear at all peers, you can change branches together, etc

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

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

-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

VERSION

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