---
name: "teamtype-share"
section: "1"
platform: "linux"
package: "teamtype"
version: "0.9.3-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/teamtype-share"
---

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