go-libfossil: Artifact [c8f7f6ea89]

Artifact c8f7f6ea89ba81404b1bb01aa3727a4ea67e7b564b0398241af0cdbf4a4544c9:

File docs/site/content/docs/reference/cli/repo-clone.md — part of check-in [94bff91c0d] at 2026-10-24 00:02:06 on branch main — feat: clone a horizon by name and depth
CloneOpts.HorizonName and HorizonDepth, and repo clone --horizon NAME --depth N, ask the origin for the horizon by name; CloneResult reports the resolved check-in, the steps taken and whether the clone resolved it locally. A full hash with no depth is still sent as the hash itself. Docs and the generated CLI reference and conformance data follow. (user: [email protected], size: 2932) [annotate] [blame] [check-ins using] [more...]

title: 'repo clone' weight: 20 generated: true

description: 'Clone a remote repository'

Usage: libfossil repo clone [<url> [<path>]] [flags]

Clone a remote repository

Arguments:
  [<url>]     Remote Fossil server URL
  [<path>]    Local path for new repository file

Flags:
  -h, --help                     Show context-sensitive help.
  -R, --repo=STRING              Path to repository file
  -v, --verbose                  Verbose output

  -u, --user=STRING              Username for clone auth
  -p, --pass=STRING              Password for clone auth
      --invite=STRING            Invite token (from fossil invite)
      --timeout=10m              Abort the clone if it runs longer than this;
                                 0 disables the deadline
      --horizon=STRING           Clone a horizon store: elide blobs below this
                                 check-in, given as tip, a branch or tag,
                                 or its full 40 or 64 digit hash; the origin
                                 resolves a name, or the clone does over what
                                 an origin that cannot sends it; what each rule
                                 would hold needs a local repository ('repo cone
                                 cost') or a peer that exposes it out of band,
                                 as the origin's horizon-served URL may
      --depth=INT                With --horizon, step the check-in back this
                                 many check-ins along primary parents, stopping
                                 at a root
      --leaves                   With --horizon, also hold every open leaf's
                                 ancestry back to the check-in, for merging
                                 across live branches offline; costly: on a
                                 repository with old unmerged branches that is
                                 nearly the whole history
      --structural               With --horizon, also elide the manifests below
                                 the check-in, deriving their branch and tag
                                 state from the origin's seed
      --cone=CONE,...            Clone a sparse store: fetch only this path's
                                 subtree (repeatable)
      --cone-not=CONE-NOT,...    Carve this path out of a --cone (repeatable)
      --seed-key=STRING          The origin's public key, an SSH public key line
                                 or an OpenPGP fingerprint: with --structural, a
                                 horizon seed not signed by it is discarded and
                                 the clone falls back to the content horizon;
                                 kept as the horizon-seed-key setting