Skip to content
tg

tg repo create

Create a repository on Tangled

Synopsis

Section titled “Synopsis”

Create a repository on Tangled.

The repository is provisioned on the Knot selected by –knot, TG_KNOT, or tg configuration. When none is selected, tg reads your sh.tangled.knot registrations from your PDS and verifies each Knot’s sh.tangled.owner response against your DID. At most 10 registrations are considered; select a Knot explicitly when you have more. One verified Knot is selected automatically. If no registrations exist, tg falls back to knot1.tangled.sh. Registrations with no successful verification stop creation. Failed registrations produce warnings when another registration succeeds, and multiple verified Knots require an explicit selection. Discovered hosts are contacted through your machine’s normal DNS and HTTPS networking; private hosts are allowed. A sh.tangled.repo record is written to your PDS. The repository name is used as the record key, matching the current Tangled schema.

Use –clone to clone the new repository into the current directory, or –push= to push an existing local repository at that path to the new remote (and set its current branch as the default branch).

Requires authentication (run “tg auth login” first).

tg repo create <name> [flags]

Options

Section titled “Options”
      --clone                Clone the new repository into the current directory
      --description string   Repository description
  -h, --help                 help for create
      --knot string          Knot host to provision and optionally push to (overrides TG_KNOT, config, and automatic discovery)
      --push string          Push an existing local repository at this path to the new remote (e.g. .)
      --remote string        Remote name to use with --push (default "origin")
      --ssh-port string      SSH port for cloning from or pushing to the selected Knot (overrides config file and TG_SSH_PORT) (default "22")

Options inherited from parent commands

Section titled “Options inherited from parent commands”
      --account string   Account handle or DID to use (overrides the active account and TG_ACCOUNT)
      --appview string   Appview host URL (overrides config file and TG_APPVIEW) (default "https://bobbin.klbr.net")
      --config string    Path to config file (default: $XDG_CONFIG_HOME/tg/config.toml)
      --json             Output in JSON format

SEE ALSO

Section titled “SEE ALSO”
  • tg repo - Manage repositories on Tangled